Skip to content

Document --dry-run option for propose-downstream and pull-from-upstream#1148

Draft
gordonmessmer wants to merge 1 commit into
packit:mainfrom
gordonmessmer:dry-run
Draft

Document --dry-run option for propose-downstream and pull-from-upstream#1148
gordonmessmer wants to merge 1 commit into
packit:mainfrom
gordonmessmer:dry-run

Conversation

@gordonmessmer

@gordonmessmer gordonmessmer commented Jul 8, 2026

Copy link
Copy Markdown

Add documentation for the new --dry-run flag:

  • Update help output sections with --dry-run option
  • Add "Dry-run mode" sections to both command docs
  • Explain what operations continue in dry-run mode (downloads, syncing, local commits)
  • Explain that sources file is updated using fedpkg new-sources --offline
  • Explain what operations are skipped (lookaside uploads, pushes, PR creation)
  • Provide usage examples and use cases
  • Clarify when to use each command (upstream vs dist-git repo)

This complements the packit PR adding --dry-run functionality.

TODO:

  • Write new tests or update the old ones to cover new functionality.
  • Update doc-strings where appropriate.
  • Update or write new documentation in packit/packit.dev.

Fixes packit/packit#1952

RELEASE NOTES BEGIN

Packit now supports dry-run for the propose-downstream and pull-from-upstream commands.

RELEASE NOTES END

Add documentation for the new --dry-run flag:
- Update help output sections with --dry-run option
- Add "Dry-run mode" sections to both command docs
- Explain what operations continue in dry-run mode (downloads, syncing, local commits)
- Explain that sources file is updated using fedpkg new-sources --offline
- Explain what operations are skipped (lookaside uploads, pushes, PR creation)
- Provide usage examples and use cases
- Clarify when to use each command (upstream vs dist-git repo)

This complements the packit PR adding --dry-run functionality.

Co-authored-by: Claude <claude@anthropic.com>
Signed-off-by: Gordon Messmer <gmessmer@redhat.com>
@centosinfra-prod-github-app

Copy link
Copy Markdown
Contributor

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Allow packit propose-downstream to do a local "dry-run"

1 participant