Skip to content
This repository has been archived by the owner on Oct 28, 2019. It is now read-only.

Improve, cleanup API-docs #51

Merged
merged 1 commit into from
Feb 12, 2019
Merged

Improve, cleanup API-docs #51

merged 1 commit into from
Feb 12, 2019

Conversation

mdellweg
Copy link
Member

@mdellweg mdellweg commented Feb 8, 2019

[noissue]

@codecov
Copy link

codecov bot commented Feb 8, 2019

Codecov Report

Merging #51 into master will not change coverage.
The diff coverage is n/a.

Impacted file tree graph

@@           Coverage Diff           @@
##           master      #51   +/-   ##
=======================================
  Coverage   42.33%   42.33%           
=======================================
  Files          22       22           
  Lines         711      711           
=======================================
  Hits          301      301           
  Misses        410      410
Impacted Files Coverage Δ
pulpcore/plugin/stages/association_stages.py 23.07% <ø> (ø) ⬆️
pulpcore/plugin/stages/declarative_version.py 33.33% <ø> (ø) ⬆️
pulpcore/plugin/stages/api.py 65.55% <ø> (ø) ⬆️

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update d80e828...fbcf802. Read the comment docs.

Copy link
Contributor

@asmacdo asmacdo left a comment

Choose a reason for hiding this comment

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

Looking good-- I didn't approve just because it's WIP. I'd be happy to merge as-is.

@@ -34,7 +34,7 @@ serializer needs to add that field as well.
)

class Meta:
fields = ContentSerializer.Meta.fields + ('relative_path',)
fields = SingleArtifactContentSerializer.Meta.fields + ('relative_path',)
Copy link
Contributor

Choose a reason for hiding this comment

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

nice catch

@mdellweg mdellweg changed the title WIP: Improve, cleanup API-docs Improve, cleanup API-docs Feb 11, 2019
@mdellweg
Copy link
Member Author

@asmaco I updated the PR to the latest additions to the stages API and removed the WIP status.

@mdellweg mdellweg force-pushed the stages_doc branch 2 times, most recently from 87ceba4 to db59ed6 Compare February 12, 2019 13:19
@@ -33,6 +33,10 @@ working directory setup, and database cleanup after encountering failures.
Synchronizing
-------------

.. tip::

Please consider using the high level :ref:`stages-docs` for actual implementations.
Copy link
Contributor

Choose a reason for hiding this comment

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

"""
This method drains items from the last queue and drops them.

Especially it does not try to put items into the nonexistent next queue.
Copy link
Contributor

Choose a reason for hiding this comment

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

Optional nitpick: s/Especially/Importantly/

@@ -91,7 +91,8 @@ class RemoveDuplicates(Stage):
"""
Stage allows plugins to remove content that would break repository uniqueness constraints.

This stage is expected to be added by the DeclarativeVersion. See that class for example usage.
This stage is expected to be added by the
:class:`~pulpcore.plugin.stages.DeclarativeVersion`. See that class for example usage.
Copy link
Contributor

Choose a reason for hiding this comment

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

👍

Copy link
Contributor

@asmacdo asmacdo left a comment

Choose a reason for hiding this comment

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

I'd like to hear from @jortel that the second use of ResolveFuture is unintended. Then :shipit:

@mdellweg mdellweg force-pushed the stages_doc branch 2 times, most recently from 1c9b94d to aa2f44d Compare February 12, 2019 15:22
@asmacdo
Copy link
Contributor

asmacdo commented Feb 12, 2019

@jortel, we aren't removing the second RemoveFuture anymore, so merging now.

@asmacdo asmacdo merged commit c0a1032 into pulp:master Feb 12, 2019
@mdellweg mdellweg deleted the stages_doc branch February 13, 2019 10:26
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
2 participants