This release is a pre-release and may not be stable for production use.
A meta-package manager for all porridges
Porringer
A CLI and Python API for synchronizing developer environments from a declarative manifest. Porringer reads the packages, tools, runtimes, repositories, and project sync work you want, then delegates the actual work to installed package managers through plugins.
Features
- Manifest-driven setup from
porringer.jsonor[tool.porringer]inpyproject.toml. - Plugin-based installers for Python, Node, system packages, project sync, runtimes, and source repositories.
- Read-only previews with stable action IDs, command previews, diagnostics, and JSON output.
- Sync strategies for minimal installs, latest allowed versions, or exact declared constraints.
- JSONL progress streams, replay records, and trace artifacts for downstream clients.
- Python APIs for inspection, execution, cached projects, profiles, tools, progress events, and client snapshots.
Quick Start
Install Porringer into an isolated CLI environment, then preview a manifest before running it:
pipx install porringer
porringer preview examples/python-dev
porringer install examples/python-dev
See Setup for uv, pip, and development checkout instructions.
Development
Porringer uses PDM for local development. Common tasks are defined in pyproject.toml under [tool.pdm.scripts]:
pdm install
pdm run test
pdm run generate
See Development for test lanes, traces, smoke tests, and diagnostics.
For contribution guidelines, see CONTRIBUTING.md.
Documentation
- Documentation home
- Setup
- Install links
- Install command
- Preview command
- Check command
- Download command
- API surface
- Development
License
This project is licensed under the MIT License. See LICENSE.md for details.
Copyright © 2025 Synodic Software
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 porringer-0.2.1.dev91.tar.gz.
File metadata
- Download URL: porringer-0.2.1.dev91.tar.gz
- Upload date:
- Size: 339.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
412e2dce84fcfef17dfa1a341d60d79c7c78f8f32b140b4bb373a49c0c37c49b
|
|
| MD5 |
ce9292c464de7a94ef9672ad59e8cb9b
|
|
| BLAKE2b-256 |
f5f1dbad8c6062d435f2698c953fbeacf0260b70c4a89290b149b1dc2efb42bd
|
File details
Details for the file porringer-0.2.1.dev91-py3-none-any.whl.
File metadata
- Download URL: porringer-0.2.1.dev91-py3-none-any.whl
- Upload date:
- Size: 256.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
449065c6263d3e77c2bd204b3e6e00e728be205afb6eb3a246e000c90131cd53
|
|
| MD5 |
67c7e01b690cc603326bd16f5e9a805e
|
|
| BLAKE2b-256 |
a354c3cd65d9e2e179b87e0651a39f6d6a4cb6d7012169147001ee10cbf32dbb
|
