Changelog¶

0.24.0 (2024-03-11)¶

Features¶

Add plugins configuration option to select which plugins to load. #291
Added import export support of python content. #609
Added support for the dbus secret service to make use of password managers. #821
Added --header parameter to allow passing an arbitrary number of custom headers along with every request. #889

Bugfixes¶

User-entered order of parameters no longer matters for repository version commands. #650
Fixed a regression introduced in get_translations. #874
Fixed the distribution of extra files with the package. This should fix both type annotations as well as translations.

Improved Documentation¶

Better separate the concepts of cli and glue in the architecture docs.

Deprecations and Removals¶

Dropped support for python 3.6 and 3.7.

Pulp GLUE¶

Features¶

Added auth to apikwargs so you can plug in any requests.auth.AuthBase. #821
Added auth_provider to api_kwargs to allow flexible authentication schemes driven by the openapi3 specs.

Bugfixes¶

Added a missing check for uniqueness on entity lookup. #894
Fixed the distribution of extra files with the package. This should fix both type annotations as well as translations.

Improved Documentation¶

Fixed the style to display the type of objects in the code reference docs.

Deprecations and Removals¶

Dropped support for python 3.6 and 3.7.

0.23.2 (2024-01-22)¶

Bugfixes¶

Fixed a regression introduced in get_translations. #874

Pulp GLUE¶

No significant changes.

0.23.1 (2024-01-18)¶

Bugfixes¶

Fixed the distribution of extra files with the package. This should fix both type annotations as well as translations.

Pulp GLUE¶

Bugfixes¶

Fixed the distribution of extra files with the package. This should fix both type annotations as well as translations.

0.23.0 (2024-01-16)¶

Features¶

Switched the buildsystem from using setup.py to using pyproject.toml.
Ansible Collection upload now uses the Pulp V3 API and uploading directly to a repository with --repository. #844
Added support for --checksum-type option (combination of --package-checksum-type and --metadata-checksum-type) when creating rpm publications and configuring rpm repository publish settings. #850

Bugfixes¶

Fixed a bug where the filenames on uploads were not being sent. #842
Remove dependency on pkg_resources that failed some installations but is deprecated anyway. #865

Improved Documentation¶

Improved Developer Material/Architecture section by adding clarification about pulp-glue, version guards and pulp_option factory. #836
Clarified how to handle version specifiers when testing the CLI for unreleased plugin versions (.dev). #852
Added information how to use pipx for installation.

Deprecations and Removals¶

Marked option --sqlite-metadata on pulp rpm repository update/create unavailable for pulp_rpm>=3.25.0, as it was removed there. #831

Pulp GLUE¶

Deprecations and Removals¶

Added version restriction to prevent the use of sqlite_metadata attribute on Repository and Publication contexts for pulp_rpm>=3.25.0. #831
Adjusted to pulp_rpm>=3.25 no longer allowing publishing repositories with md5, sha1, or sha224 checksums. #851

0.22.0 (2023-12-04)¶

Features¶

Added the ability to reclaim disk space (cmd: 'pulp repository reclaim'). #620
Added --repo-config option to the rpm repository and publication.

Bugfixes¶

Arguments --gpgcheck and --repo-gpgcheck in creating a rpm repository no longer fail to convert to integer. #677
Fixed a crash in pulp domain when a default value for --domain was provided in the config file. #769
Fixed a bug where not all commands of a command group were listed in the help and available to the auto-completion. #781

Improved Documentation¶

Added a version select widget to docs.
Added reference docs for pulpcore.cli.common.generic.

Pulp GLUE¶

Features¶

Added 'PulpGenericRepositoryContext' class to handle repository commands not available with subtypes. #620
Added repo_config option PluginRequirement checks to the PulpRpmRepositoryContextand PulpRpmPublicationContext.
Added parameter pulp_href to PulpRepositoryVersionContext and number to PulpRepositoryContext.get_version_context.
Use the labels api starting with pulpcore 3.34.

Improved Documentation¶

Add API reference docs for pulp-glue. #808

Translations¶

Added translation files machinery for pulp-glue. #634

0.21.4 (2023-10-02)¶

Improved Documentation¶

Added a version select widget to docs.

Pulp GLUE¶

No significant changes.

0.21.3 (2023-09-22)¶

No significant changes.

Pulp GLUE¶

No significant changes.

0.21.2 (2023-08-11)¶

Bugfixes¶

Fixed a crash in pulp domain when a default value for --domain was provided in the config file. #769

Pulp GLUE¶

No significant changes.

0.21.1 (2023-08-04)¶

No significant changes.

Pulp GLUE¶

No significant changes.

0.21.0 (2023-08-03)¶

Features¶

Added role subcommands to rpm commands. #630
Added upstream-pulp command group. #699

Bugfixes¶

Narrow down click version given a breaking change on 8.1.4. #715
Pinnend PyYAML version to fix installation issues. #724
Made api-quirks idempotent to prevent them from failing once the original api is fixed. #752

Misc¶

#726

Pulp GLUE¶

Features¶

Added role capability to rpm contexts. #630
Added decorator api_quirk to declare version dependent fixes to the api spec. #658
Added PulpUpstreamPulpContext. #699

0.20.7 (2024-01-15)¶

Bugfixes¶

Fixed a crash in pulp domain when a default value for --domain was provided in the config file. #769

0.20.6 (2023-10-02)¶

No significant changes.

0.20.5 (2023-10-02)¶

Improved Documentation¶

Added a version select widget to docs.

0.20.4 (2023-09-22)¶

No significant changes.

0.20.3 (2023-07-28)¶

Bugfixes¶

Made api-quirks idempotent to prevent them from failing once the original api is fixed. #752

0.20.2 (2023-07-19)¶

Bugfixes¶

Pinnend PyYAML version to fix installation issues. #724

0.20.1 (2023-07-07)¶

Bugfixes¶

Narrow down click version given a breaking change on 8.1.4. #715

0.20.0 (2023-06-28)¶

Features¶

Add '--metadata-signing-service' option to rpm. #605
Added PEP-440 version specifiers to PluginRequirement and pulp debug has-plugin. #681
Added --content-guard option to distributions. #697

Bugfixes¶

Renamed domains command group to domain to follow the cli convention. #685
Fixed some tests that made assumptions that worked, but were nonetheless incorrect. #692

Deprecations and Removals¶

Deprecate the use of min and max in PluginRequirement. #681

0.19.5 (2023-07-28)¶

Bugfixes¶

Made api-quirks idempotent to prevent them from failing once the original api is fixed. #752

0.19.4 (2023-07-19)¶

Bugfixes¶

Pinnend PyYAML version to fix installation issues. #724

0.19.3 (2023-07-10)¶

Bugfixes¶

Narrow down click version given a breaking change on 8.1.4. #715

0.19.2 (2023-05-22)¶

Bugfixes¶

Fixed some tests that made assumptions that worked, but were nonetheless incorrect. #692

0.19.1 (2023-05-02)¶

No significant changes.

0.19.0 (2023-04-14)¶

Features¶

Added a pulp repository version list command. This allows to find repository versions containing content. #631
Added HREF_PATTERN to PulpSigningServiceContext class. #653
Added more digests lookups to artifacts #662
Added support for x509 and rshm cert guards. #673

Bugfixes¶

Fixed the generic-publications command. #665

Improved Documentation¶

Fixed the installation from source instructions to include the glue layer. #654
Added pulp-cli-maven to the list of known plugins. #656

Deprecations and Removals¶

Removed deprecated commands pulp orphans and pulp debug task-summary. #670

0.18.2 (2023-07-30)¶

Bugfixes¶

Pinnend PyYAML version to fix installation issues. #724
Made api-quirks idempotent to prevent them from failing once the original api is fixed. #752

0.18.1 (2023-07-10)¶

Bugfixes¶

Narrow down click version given a breaking change on 8.1.4. #715

0.18.0 (2023-03-09)¶

Features¶

Added support for 3.23 multi-tenancy feature Domains. #642
Added known plugin requirements to the glue library layer. #645

Bugfixes¶

Reimport some missing symbols into their old location for compatibility. #635
Fixed problem where rpm-repository-sync ignored --no-optimize. #648

0.17.1 (2023-02-17)¶

Bugfixes¶

Reimport some missing symbols into their old location for compatibility. #635

0.17.0 (2023-02-16)¶

Features¶

Updated the --requirements option for ansible remotes to handle both files and strings. #230
Made all commands referencing entities accept both the HREF and name of the resource via the same command option. For example, users can additionally use the --repository option in repository show commands. #475
Added remove-image command to pulp_container. #566
Made the context layer independent of click to allow it being used like a library. #597
Exposed treeinfo as an option for sync --skip-type for RPM repositories. #614
Added the pulp task summary command as a replacement for pulp debug task-summary. #625
Added new client library pulp-glue as a spin off of the pulp-cli. #628

Bugfixes¶

Deprecated --fields and --exclude-fields on pulp ansible content list in favor of --[exclude-]field. #602

Deprecations and Removals¶

Removed pass_*_context helpers from context layer. They moved to generic layer in 0.15.0. #597
Deprecated pulp debug task-summary in favor of pulp task summary. #625

Misc¶

#558, #580

0.16.0 (2022-11-10)¶

Features¶

Added --max-retries option to remotes. #227
Added the ability to set labels directly on create and update. #274
Added the --repository parameter to some upload commands. #385
Introduced the option --wait for the pulp task-group show command. By using this option, details of the task group will be shown only after waiting for all related tasks to finish. #459
Added --optimize and --sync-options to the rpm repository sync subcommand. #462
Added pulp debug openapi schema and pulp debug openapi schema-names to investigate reusable schemas in the api. Renamed the original pulp debug openapi schema command to pulp debug openapi spec. #534
Added support for adjusting list output: --ordering, --field, --exclude-field. #542
Added task filtering options. #543
Added --cid option and started reusing a recieved correlation id in all requests made by the same command. #568

Bugfixes¶

Allowed remote timeout and rate limiting parameters to be nulled by passing "". #227
The openapi layer now handles all instances of requests.RequestException. This will help to give a better error message for e.g. missing schema in the --base-url parameter. #466
Fixed an error raised when specifying no HREF value for some of the commands. #545
Fixed an assertion error when canceling tasks by state. #561
Fixed KeyError: 'missing_field' error when required fields are not supplied. #572
Correctly identified base_path as required when creating a Distribution. (affected rpm, file, and python distribution create) #574

Misc¶

#569, #589

0.15.0 (2022-07-20)¶

Features¶

Added pulp_container repository list/add/remove content commands. #422
Added role management commands to file commands. #454
Added role management to container subcommands. #468
Added support for ULN remotes. #470
Added ansible signature command. #481
Added ansible signature list/read/upload commands. #484
The --type option on the repository content subgroup has moved back one spot. To list all the content types in a repository use the --all-types flag on the list command. #492
Added container repository copy-tag and copy-manifest commands. #497
Extended "rpm content" to cover all of the RPM content-types. #505
Added commands for the redirecting content guard. #512
Started using uploads directly to create file content of a bigger size with pulpcore >= 3.20. #514
Added global publication list command. Also, added new --repository filter for publication list available for pulpcore>=3.20. #515
Added global distribution list command. #517
Added global remote list command. #518
Added --repository option to ansible collection signature upload and --gpgkey to ansible repository. #532

Bugfixes¶

Fixed bug, where the failure to load config file due to the lack of file permissions lead to a crash. Now those files are simply ignored. #509
Fixed the heuristics for the PARTIAL_UPDATE_ID workaround. #529
Fixed uploading content for files smaller than the chunk size. #535

Deprecations and Removals¶

Marked group permission command unusable with pulpcore 3.20. #501

Misc¶

#499, #520

0.14.1 (2022-07-15)¶

Bugfixes¶

Fixed the heuristics for the PARTIAL_UPDATE_ID workaround. #529

0.14.0 (2022-03-02)¶

Features¶

Added content list/show commands for container blob/manifest/tag content types. #421
Added tag/untag commands to add and remove tags from images in container repositories. #423
Added a --task-group filter parameter to task list. #451
Added the api_root setting to allow communicating with a pulp installation on a nonstandard path. #453
Allow to fetch the config profile from the environment variable PULP_CLI_PROFILE. #463

Bugfixes¶

Fixed missing help text on path option for ACS create commands. #446
Fixed a bug in reporting the failure of a task if the reason was not an exception in the task code. #464
Fix rpm distribution update command failing when trying to enable/disable auto-distribute. #472

Improved Documentation¶

Add default help text for options taking a generic resource argument. #387

Developer Notes¶

Introduced ID_PREFIX on PulpEntityContext to generate most operation ids. #444
Added needs_capability to EntityContext so context member function can require capabilities. #465

0.13.0 (2021-12-16)¶

Features¶

Allow path to certificate bundle to be specified via PULP_CA_BUNDLE, REQUESTS_CA_BUNDLE or CURL_CA_BUNDLE environment variables. Use proxy settings from environment. #95
Users can now specify --client-cert, --ca-cert, and --client-key using @filepath. #220
Added facilities to create, load and distribute translations. #328
Added upload and show commands for Ansible Roles and Collection-Version content #362
Added content management commands for Ansible repositories #363
Added commands to manage roles and their association with users and groups. Added commands to add and remove users. #382
Added --content-hrefs and --protection-time options to orphan cleanup command. #398
Added support for the comps.xml upload to the rpm plugin. #406
Added remote option for Python distributions. #417
Added a customized user agent to api calls. #426
Added support for "tasks purge". #430
Added reset command to access policies. Changed --permissions-assignment to --creation-hooks to follow pulpcore 3.17 naming. #438
Add a generic command group for object permission management. Added object permission management to tasks, groups and RBAC content guards. #439

Bugfixes¶

Fixed a bug where in the version lookup, where "--version 0" lead to latest. #415

Improved Documentation¶

Updated docs home page to reflect current plugin support of the CLI. #394
Added Supported Worklows page to detail the workflows and features of the CLI. #395

Translations¶

Added some German translations. #328

0.12.0 (2021-10-06)¶

======================

Features¶

Chunked artifact and content uploads now allow unit specifier in --chunk-size option #260
Added rpm package content commands support. #284
Added the ability to pass an href to a resource option. #315
Added pulp file acs command. #324
Added --all, --waiting and --running flags to allow bulk task cancel. #330
Added commands for CRUD RBAC Content Guards. #352
Added the ability to delete tasks. #376
Added refresh command for pulp_file Alternate Content Sources. #377
Added pulp_rpm Alternate Content Source commands. #378
Added the openapi command group to debug to ease reading the schema. #384

Bugfixes¶

Fixed the referenced version with the --version parameter. #351
Fixed nullable fields for rpm remote. #373

Improved Documentation¶

Add installation instructions for plugins and a list of known plugins. #331
Moved CHANGES.md to publish them along with the documentation. #336
Reformatted CHANGES with Markdown syntax. #337
Add a tabular view to the global options. #357

Deprecations and Removals¶

Bumped required pulpcore version to >=3.11 and removed legacy workarounds. #380

Misc¶

#342

0.11.0 (2021-08-10)¶

Features¶

Added support to specify skip-types on rpm sync. #225
Added lookup for a global config file /etc/pulp/cli.toml. #290
Changed default config location to <app-dir>/cli.toml. The old file will still be read. #293
Enable exports for ansible repositories. #302
Added --sles-auth-token to rpm remote commands. #305
Added ansible content list command. #327

Bugfixes¶

Added validation to some json input parameters. #255
Fixed a bug in the docs publishing workflow. #286
Unconditionally add the fake not namespaced pulp_cli to the distribution on pypi to make it able to be consumed by setuptools<40. #287
Deprecate orphans delete command in favor of orphan cleanup and use new rest interface on pulpcore>=3.14. #297
Changed the name of retained-versions to retain-repo-versions. #298
Improved a confusing error message around pulp components. #299
Added minimum of 1 to --limit option. #311

0.10.1 (2021-06-30)¶

Bugfixes¶

Fixed a bug in the docs publishing workflow. #286
Unconditionally add the fake not namespaced pulp_cli to the distribution on pypi to make it able to be consumed by setuptools<40. #287

0.10.0 (2021-06-30)¶

Features¶

Change resource options to accept plugin and type along with the name. #158
Added missing search options to publication list commands. #207
Add a timeout parameter to specify the duration how long to wait for background tasks. #232
Python remote fields --includes/--excludes can now be specified with requirements.txt files #240
Updated RPM commands to be compatible with new 3.13 auto-publish changes #251
Added generic content list command. #254
Update the click dependency to 8.0.1. #256
Added feature to bypass chunk uploading if the chunk size exceeds the file size. This speeds up the upload by about 30-40%. #262
Added --cid option to task list command to allow fitering by correlation id. #269
Added allow-uploads/block-uploads option to python distribution commands #271

Bugfixes¶

Properly report timed out tasks. #232
Use find_packages instead of find_namespace_packages in setup to be compatible with setuptools<39.2.0. #248

0.9.0 (2021-05-17)¶

Features¶

Disabled following of redirects and added better handling of response codes. #221
Added --force as the inverse of --dry-run and started to allow dry_run in the settings. #236
Added config validation to config create and config edit. #239

Bugfixes¶

Fixed extra request when using the repository version option. #223
Fix requirements file option for ansible collection remote commands. #226
Properly truncate file before saving settings in config edit. #239

Misc¶

#235

0.8.0 (2021-04-30)¶

Features¶

Added support for autopublish and autodistribute in pulp_file and pulp_rpm. #155
Added a confirmation whether to continue with invalid config. #156
Repository content commands are now nested under a new content subgroup. #171
Added an interactive-shell mode to pulp-cli. #181
Added label command to ansible distribution group. #185
Added signing-service list and show commands. #189
Added new pulp python 3.2 remote options. #208
Added retained_versions option to repository commands. #210
Added the task-group subcommand. #211
Added mirror flag support for pulp rpm repository sync. #212
Added support for file paths for plan argument for migration plan create command. #213

Bugfixes¶

Improved the error message, when a required server component is missing. #184

Deprecations and Removals¶

Repository add/remove/modify commands have now been deprecated. Please use the new content subgroup commands. #215

Misc¶

#190

0.7.0 (2021-03-15)¶

Features¶

Added the python command group. #73
Distributions can now be listed with options --base-path and --base-path-contains. #134
Taught rpm/repository about the retain-package-versions attribute. #172
Added the container namespace command group. #176

0.6.0 (2021-02-26)¶

Features¶

In pulpcore 3.11, the component names changed to fix a bug. This ported pulp-cli to use the new names and provides dictionary named new_component_names_to_pre_3_11_names in the pulpcore.cli.common.context module which provides new to old name mappings for a fallback support. pulp-cli plugins can add to this list by importing and modifying that dictionary also. #153

0.5.0 (2021-02-20)¶

Features¶

Made task state a choice option for pulp task list. #115
Added support for pulp-2to3-migration. #133
Added worker command. #144
Added the ability to include multiple server profiles into the pulp cli config. #145

Misc¶

#148

0.4.0 (2021-02-10)¶

Features¶

Added config commands to manage pulp-cli's config. #111
Added support for client certificate auth. #122
Added --href options to address rpm resources. #124

Bugfixes¶

Improve handling of background option and ctrl-c with tasks. #85
Added read capability to rpm remote. #125

Deprecations and Removals¶

Moved the location of --repository option after the last command for version commands. #123

Misc¶

#91, #118

0.3.0 (2021-02-04)¶

Features¶

Added label commands. #100

Bugfixes¶

Fixed missing READ_ID error for pulp file remote show. #107

Misc¶

#89

0.2.0 (2021-01-26)¶

Features¶

Basic CRUD support for Ansible repositories
Basic CRUD for Ansible role remotes, use -t role after remote to select type
Basic CRUD for Ansible collection remotes, use -t collection after remote to select type
Sync roles/collections with pulp ansible repository sync --name {repo_name} --remote {remote_name}
Postponed all server calls to the point, where a command is ready to be performed. This allows to access all help screens even if there is no server available.
Added subcommand to modify file repository with many content units in one command.
Added update command for file distribution.

0.1.0 (2021-01-15)¶

Initial release of pulp-cli.