uvault
Development and vaulting workflow for uv VCS dependencies.
Secure your Python projects against deleted or force-pushed upstream commits. uvault automatically vaults transient VCS references (like GitHub PRs) into your organization's own repositories, while allowing developers to instantly switch dependencies into local editable mode—fully integrated with pyproject.toml and uv.
Key Features
- Vaulting of Commits: Never lose code again! Upstream pull requests and branches can be force-pushed or deleted.
uvaultfetches the exact commits your project depends on and pushes them as immutable tags to your own organization's vault repository. - Easy Local Development: Switch any VCS dependency to local "editable" mode in seconds.
uvault developclones the package locally and seamlessly configuresuvto use your local copy so you can test changes and contribute back. - Automatic GitHub Forking: When a dependency's repository doesn't exist in your vault organization,
uvaultautomatically forks the upstream repository using the GitHub API (via the[github]extra), making the setup completely transparent. - Status Monitoring: Instantly check the health of all your VCS dependencies.
uvault statusshows if PRs are merged or closed, flags new remote commits, and automatically detects orphaned commits caused by upstream force-pushes.
Documentation
The complete documentation is available in the docs/ folder:
- Quickstart & Key Features - Learn what
uvaultis and how to get started quickly. - How-To Guides - Step-by-step guides for installing and using
uvaultin your day-to-day workflow. - CLI & Configuration Reference - Detailed information on
pyproject.tomlconfiguration ([tool.uvault]) and all CLI commands (sync,add,develop).
Contributing
Contributions are welcome! If you're interested in improving uvault, please check out our Contributing Guide for details on setting up your development environment, running tests, and submitting PRs.
Credits & Acknowledgements
A huge thank you to Stéphane Bidoul for his continuous inspiration, and particularly for the work on pip-preserve-requirements which strongly influenced the vision and design of this project.
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 uvault-0.5.0.tar.gz.
File metadata
- Download URL: uvault-0.5.0.tar.gz
- Upload date:
- Size: 120.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e07ddc32e8f43bfd9bbf7bd0e1f7132e51e8713ca9e2d2c600f5ecf04ca00f02
|
|
| MD5 |
f4f857359362cdbf220a208e9a9d2f9e
|
|
| BLAKE2b-256 |
3f136414611a4d04653d84dca26a75c071761913244f24dd3006c133f6befc45
|
Provenance
The following attestation bundles were made for uvault-0.5.0.tar.gz:
Publisher:
release.yml on petrus-v/uvault
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
uvault-0.5.0.tar.gz -
Subject digest:
e07ddc32e8f43bfd9bbf7bd0e1f7132e51e8713ca9e2d2c600f5ecf04ca00f02 - Sigstore transparency entry: 1824168434
- Sigstore integration time:
-
Permalink:
petrus-v/uvault@1d60b1a73319d56044f0d891acc3dddb381aaa4d -
Branch / Tag:
refs/tags/v0.5.0 - Owner: https://github.com/petrus-v
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@1d60b1a73319d56044f0d891acc3dddb381aaa4d -
Trigger Event:
push
-
Statement type:
File details
Details for the file uvault-0.5.0-py3-none-any.whl.
File metadata
- Download URL: uvault-0.5.0-py3-none-any.whl
- Upload date:
- Size: 20.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bee1725c922032decf375738d9bf983ba913dc2c83dc1ff9023e5ad66403cb8a
|
|
| MD5 |
ce944c95ec26934f6953f923c61edf64
|
|
| BLAKE2b-256 |
a5aba1f4b379224f35bb3a56d5d2e34ec99162293e2161476a77ccd39a7c5505
|
Provenance
The following attestation bundles were made for uvault-0.5.0-py3-none-any.whl:
Publisher:
release.yml on petrus-v/uvault
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
uvault-0.5.0-py3-none-any.whl -
Subject digest:
bee1725c922032decf375738d9bf983ba913dc2c83dc1ff9023e5ad66403cb8a - Sigstore transparency entry: 1824168606
- Sigstore integration time:
-
Permalink:
petrus-v/uvault@1d60b1a73319d56044f0d891acc3dddb381aaa4d -
Branch / Tag:
refs/tags/v0.5.0 - Owner: https://github.com/petrus-v
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@1d60b1a73319d56044f0d891acc3dddb381aaa4d -
Trigger Event:
push
-
Statement type:
