A "dev-shell" for Python projects ;)

This small project is intended to improve the start-up for collaborators.

The idea is to make the project setup as simple as possible. Just clone the sources and start a script and you're done ;)

Why in hell not just a Makefile? Because it doesn't out-of-the-box under Windows and MacOS, the dev-shell does ;)

Run Tests? Just start the script and call the "run test command".

The "dev-shell" is the base to create a CLI and a shell. It also shows how to make a project bootstrap as simply as possible, e.g.:

At least uv is needed. Install e.g.: via pipx:

apt-get install pipx
pipx install uv

Clone the project and just start the CLI help commands. A virtual environment will be created/updated automatically.

~$ git clone https://codeberg.org/jedie/dev-shell.git
~$ cd dev-shell
~/dev-shell$ devshell.py --help
~/dev-shell$ devshell.py test

The output looks like:

Cmd2 Commands
─────────────
alias  help  history  macro  quit  set  shortcuts

dev-shell commands
──────────────────
coverage        install             publish    test    version
fix_code_style  list_venv_packages  pyupgrade  update

compatibility

See also:

• github test configuration: .github/workflows/test.yml
• Nox configuration: noxfile.py

History

• v0.12.0
  • 2026-09-15 - Give up GitHub -> Codeberg / OpenCommit / GitLab / Redicle
  • 2026-08-07 - Use always latest versions for local development
  • 2026-08-07 - remove obsolete v3.9 fallback
  • 2026-08-07 - update outdated command docstring
  • 2026-06-11 - Update README.md
• v0.11.1
  • 2026-06-11 - fix _print_info() if Path instance pass as arguments
• v0.11.0
  • 2026-06-11 - Remove uv.lock from this repo: It's a library not a project
  • 2026-06-11 - nox: reuse venv
  • 2026-06-11 - NEW: CategorizedCommandSet replacement for @cmd2.with_default_category()
  • 2026-06-11 - fix linting
  • 2026-06-11 - Update requirements
  • 2026-05-29 - Bump uv from 0.11.6 to 0.11.15
  • 2026-04-10 - Bump uv from 0.10.4 to 0.11.6
  • 2026-04-08 - Bump cryptography from 46.0.6 to 46.0.7
  • 2026-03-30 - Bump pygments from 2.19.2 to 2.20.0
  • 2026-03-29 - Bump cryptography from 46.0.5 to 46.0.6
• v0.10.2
  • 2026-02-19 - apply manageprojects updates
  • 2026-02-19 - Bugfix colorful helpers if a Path instance should be printed.

Project links

GitHub suspended me!

Important notice:

GitHub suspended my account sometime in late August 2026 ! There was no warning beforehand, nor any explanation of the reasons afterwards. Since then, I have had no access or control over my data on GitHub.

All my projects and everything about me have completely disappeared. Everything just results in a 404 "Not Found" error page.

A support request still hasn't been answered, even after several weeks (apart from a confirmation that the request was received).

For that reason, I have been looking for a new home for all my OpenSource projects. (Or rather, I am in the process of republishing all my projects elsewhere.)

Now you can find my on these places:

• Codeberg.org/jedie
• OpenCommit.eu/jedie
• GitLab.com/users/jedie
• Radicle: did🔑z6MkfvNUuBCwRtNZwANEAGd4vaTzyuZXMKfiSyjoBALga934 | jedie.radicle.garden

That is why there will probably be a lot of broken links pointing to my GitHub account for quite some time!

#GitHubSuspendedMe #GiveUpGitHub

• Codeberg: https://codeberg.org/jedie/dev-shell/
• OpenCommit: https://opencommit.eu/jedie/dev-shell/
• GitLab: https://gitlab.com/jedie/dev-shell/
• PyPi: https://pypi.org/project/dev-shell/