tomperez98/pyrgo

Python project manager inspired in Cargo.

pyrgo

Python project manager inspired in Cargo.

pyrgo does not reinvent the wheel. It's just a unified API that leverages popular libraries to improve your development experience.

• Testing:
  • pytest
• Code formatting:
  • ruff
• Code checking:
  • ruff
  • mypy
  • vulture
• Artifacts building:
  • build
• Package management:
  • uv

All behind a unified API.

Usage: pyrgo [OPTIONS] COMMAND [ARGS]...

  pyrgo. Python package manager.

Options:
  -v, --version  Show the version and exit.
  -h, --help     Show this message and exit.

Commands:
  add     Add dependency to env.
  audit   Audit locked dependencies with `pip_audit`.
  build   Build project with `build`.
  check   Check code with `mypy`, `ruff` and `vulture`.
  clean   Clean project repository.
  doc     Build a package's documentation with `pdoc`.
  fix     Automatically fix lint warnings reported by `ruff`.
  fmt     Format code with `ruff`.
  lock    Lock project dependencies with `uv`.
  new     Create a project.
  remove  Remove dependency from env.
  sync    Sync current python environment to locked deps using `uv`.
  test    Run tests with `pytest`.

The minimal pyrgo project structure, as well as python project structure is this one:

.
├── README.md
├── pkg
│   └── __init__.py
├── pyproject.toml
└── tests
    └── test_something.py

Few extra configurations

[tool.pyrgo]
extra-paths = ["scripts"]
extra-caches = [".coverage"]
vulture-allowlist = ".allowlist"

pyrgo's Issues

Substitute fmt with format

Hey,

Thank you very much for the project. I was wondering if fmt should be kept instead of format?

Every command is a full word, while we used an abbreviation for this, although it's not a really long word.

Thanks in advance!

`remove` command

Implement the remove command.

The workflow would go as follows:
Remove dependency from the specified group in the pyproject.toml file, lock changed group and sync using new requirements/*.lock file

Detect unused code using `vulture`

vulture

Under pyrgo check we should be only evaluating for unused code.

Audit dependencies with `pip-audit`

Use pip-audit to implement a new command that audits environment dependencies.

`Add` command

Implement an add command.

The workflow would have to modify the pyproject.toml definition, adding the new dependency at the specified group. Lock the modified environment and sync to new requirments/*.lock