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
Metadata
1 maintainer
Release files for distman 0.8.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| distman-0.8.4.tar.gz | 53.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| distman-0.8.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 102.5 kB
Release files / distman-0.8.4.tar.gz
| Download URL | distman-0.8.4.tar.gz |
|---|---|
| Size | 53.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f30b6ce666c1e5e83c336be0bf2700d34be2d431c91cfc73de069c49936cd01d
|
|
BLAKE2b-256 checksum How to use checksums |
5880807daa45389842b3a8f102492248cb4dc311781353c9fc0695c7fef182bb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.8.10
|
Release files / distman-0.8.4-py3-none-any.whl
| Download URL | distman-0.8.4-py3-none-any.whl |
|---|---|
| Size | 49.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
96285a4e7d160b01d8c82fb5a4f6f20d2cb5e881089df0ade4a50cf156289b7b
|
|
BLAKE2b-256 checksum How to use checksums |
f69917b94639b574dfde47d8c2fc529650de3e372c7a782d0735177d098c2382
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.8.10
|
