Install & Compatibility
Where this runs
tested against v0.5.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.910 runs
installs and imports cleanly · install 0.0s · import 0.000s · 37.7MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 4.7s · import 0.000s · 38MB
35MB installed
● package 35MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
NotApplicable
✓ This library is primarily a command-line interface (CLI) plugin and is not typically imported for direct Python programmatic use of its commands. Instead, it extends the `pulp` CLI tool.
For programmatic interaction with the Pulp Deb REST API, use the `pulp-deb-client` library.
The quickstart involves installing the `pulp-cli-deb` package, which will also install `pulp-cli`. After installation, configure the Pulp CLI to connect to your Pulp instance by setting environment variables or creating a configuration file. Then, you can use `pulp` commands, particularly the `pulp deb` subcommand group, to manage Debian content.
# Install the CLI plugin
pip install pulp-cli-deb
# Configure Pulp CLI to connect to your Pulp instance
# Replace <PULP_BASE_URL>, <PULP_API_ROOT>, <USERNAME>, <PASSWORD> with your details
# It's recommended to set these via environment variables or a configuration file
# For example, create ~/.config/pulp/cli.toml or use `pulp config create -e`
# For demonstration, assuming a local Pulp instance and default credentials:
# export PULP_BASE_URL="https://localhost"
# export PULP_API_ROOT="/api/v3"
# export PULP_USERNAME="admin"
# export PULP_PASSWORD="password"
# Test connectivity to the Pulp API
pulp status
# List available Debian repositories
pulp deb repository list
# Get help for Debian commands
pulp deb --help
pulp deb repository --help
pulp --version
Debug
Known issues
breakingOlder versions of `pulp-cli-deb` (including some 0.4.x releases) were yanked from PyPI due to insufficient `pulp-glue-deb` dependency handling, leading to broken installations. While 0.4.3 aims to resolve this, ensure a clean installation.fixUpgrade to the latest `pulp-cli-deb` (0.4.3 or newer) and ensure `pulp-glue-deb` is also installed and up-to-date. `pip install --upgrade pulp-cli-deb pulp-glue-deb`
affects: <0.4.3
gotchaThe `pulp` CLI is primarily designed for reading information about synchronized content. Attempts to add, update, or delete certain content types directly via `pulp-cli` might result in 'Error: Call aborted due to safe mode'.fixFor write operations (add, update, delete) on certain content, consider using other Pulp management tools like the Pulp management UI, Hammer CLI, or Foreman Ansible Modules, as recommended by the documentation.
affects: All versions
deprecatedThe underlying `pulp_deb` plugin, which `pulp-cli-deb` interacts with, removed deprecated release file fields such as `PUBLISH_RELEASE_FILE_LABEL` and `PUBLISH_RELEASE_FILE_VERSION` in `pulp_deb` 3.3.0. Using these fields in older configurations might lead to unexpected behavior or errors.fixUpdate your Pulp instance's `pulp_deb` plugin to the latest version and adjust any automation or configurations that rely on these removed fields.
affects: pulp_deb <3.3.0 interactions
Upgrade
Version history
0.5.0latest on PyPI · released Jun 12, 2026
Audit
Dependencies
pulp-clirequiredThis is a plugin for pulp-cli; installing pulp-cli-deb will automatically pull in the core pulp-cli package.
pulp-glue-debrequiredProvides the 'glue' code for interacting with the Pulp Deb API. While often pulled in as a transitive dependency, explicit awareness can help troubleshoot installation issues.