distman
Simple software distribution for production pipelines.
distman performs safe, versioned rollouts of software, scripts, and configuration files to filesystem locations. It is useful when deterministic deployments, environment-aware transforms, local caching, and quick rollback matter more than conventional package installation.
That includes revision-controlled configuration repositories. distman can publish configuration into runtime filesystem scopes without needing to understand the contents of those files. In that model, Git remains the source of truth, distman handles filesystem deployment, and runtime tools such as envstack can compose the deployed files later.
Deployed objects are stored as numbered versions, while an atomic symlink selects the active version:
bin/
├── tool -> versions/tool.2.a1b2c3d
└── versions/
├── tool.1.91c8a77
└── tool.2.a1b2c3d
distman works well with envstack when you want filesystem deployment and runtime environment composition to remain separate concerns.
Installation
pip install -U distman
Install the optional JavaScript and HTML minifiers when a transform pipeline needs them:
pip install -U "distman[minify]"
Quickstart
For an ad hoc deployment, provide the source and destination directly:
dist --source path/to/tool --dest /deploy/bin/tool --dryrun
dist --source path/to/tool --dest /deploy/bin/tool --yes
Ad hoc deployments use the same versioned layout as configured deployments and match previous versions by content by default.
For repeatable project deployments, create a dist.json file at the root of a
Git repository:
{
"author": "pipeline@example.com",
"targets": {
"tools": {
"source": "tools",
"destination": "{DEPLOY_ROOT}/tools"
}
}
}
Preview and then perform the deployment:
dist --dryrun
dist --yes
Override a configured target source or destination from the CLI:
dist --source build/package --dest /deploy/lib/python/package --dryrun
dist --target tools --dest /deploy/tools --yes
The namespaced distman dist command provides the same distribution
interface. Cache a shared deployment locally with:
distcache
Documentation
Full documentation is available in the docs folder:
The documentation is also published through the repository's GitHub Pages workflow.
License
distman is distributed under the BSD 3-Clause License.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file distman-0.8.4.tar.gz.
File metadata
- Download URL: distman-0.8.4.tar.gz
- Upload date:
- Size: 53.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/5.1.1 CPython/3.8.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f30b6ce666c1e5e83c336be0bf2700d34be2d431c91cfc73de069c49936cd01d
|
|
| MD5 |
274b6368eb1ee47a25e1b76cc53dc930
|
|
| BLAKE2b-256 |
5880807daa45389842b3a8f102492248cb4dc311781353c9fc0695c7fef182bb
|
File details
Details for the file distman-0.8.4-py3-none-any.whl.
File metadata
- Download URL: distman-0.8.4-py3-none-any.whl
- Upload date:
- Size: 49.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/5.1.1 CPython/3.8.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
96285a4e7d160b01d8c82fb5a4f6f20d2cb5e881089df0ade4a50cf156289b7b
|
|
| MD5 |
6829634521c215b21854019907e15418
|
|
| BLAKE2b-256 |
f69917b94639b574dfde47d8c2fc529650de3e372c7a782d0735177d098c2382
|
