Skip to content
This repository was archived by the owner on Oct 10, 2020. It is now read-only.

syscontainers: Add code documentation#1081

Closed
ashcrow wants to merge 1 commit intoprojectatomic:masterfrom
ashcrow:code-doc-syscontainers
Closed

syscontainers: Add code documentation#1081
ashcrow wants to merge 1 commit intoprojectatomic:masterfrom
ashcrow:code-doc-syscontainers

Conversation

@ashcrow
Copy link
Contributor

@ashcrow ashcrow commented Aug 25, 2017

Description

Adds docstrings and parameter information to the public methods in syscontainers.py. Added as a way to get more comfortable with the module and hopefully help others get up to speed quicker.

Related Bugzillas

None

Related Issue Numbers

None

Pull Request Checklist:

Not needed

@ashcrow
Copy link
Contributor Author

ashcrow commented Aug 25, 2017

cc @giuseppe

Copy link
Collaborator

@giuseppe giuseppe left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

very useful! Just a small typo and I think it is ready to go


def version(self, image):
"""
Returns information on provided image in ostre. Same as foo = [inspect_system_image(image)].
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

small typo: ostree

:param image: Name of the image to pull. If not provided self.args.image is used.
:type image: str or None
"""
# TODO: guard against image and self.args.image being None?
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

apparently tests fail if this line is added

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bah. It's because TODO is considered bad by the checks. I'll remove it.

@ashcrow ashcrow force-pushed the code-doc-syscontainers branch from e608135 to d3d3f55 Compare August 25, 2017 20:56
@ashcrow ashcrow force-pushed the code-doc-syscontainers branch from d3d3f55 to f188aff Compare August 25, 2017 20:57
@giuseppe
Copy link
Collaborator

@rh-atomic-bot r+ f188aff

@rh-atomic-bot
Copy link

⌛ Testing commit f188aff with merge 2d64fe1...

@rh-atomic-bot
Copy link

☀️ Test successful - status-redhatci
Approved by: giuseppe
Pushing 2d64fe1 to master...

eyusupov pushed a commit to eyusupov/atomic that referenced this pull request Mar 10, 2018
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants