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 ;)

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

It also shows how to make a project bootstrap as simply as possible, e.g.:

~$ git clone https://github.com/jedie/dev-shell.git
~$ cd dev-shell
~/dev-shell$ ./dev-shell.py pytest

How it works

First start of the Python script ./dev-shell.py will bootstrap:

• Generate a Python virtual environment (in short: venv)
• Install poetry
• Install project dependencies and the project himself

The output on first bootstrap start looks like:

~/dev-shell$ ./dev-shell.py
Create venv here: ~/dev-shell/.venv
Collecting pip
...
Successfully installed pip-21.0.1
Collecting poetry
...
Installing dependencies from lock file

Package operations: 31 installs, 1 update, 0 removals

...

Installing the current project: dev-shell (0.0.1alpha0)


Developer shell - dev_shell - v0.0.1alpha0


Documented commands (use 'help -v' for verbose/'help <topic>' for details):

Publish
=======
publish

Tests
=====
pytest

...

(dev_shell) quit
~/dev-shell$

The first bootstrap start takes a few seconds. Each later startup detects the existing virtualenv and is very fast:

~/dev-shell$ ./dev-shell.py

Developer shell - dev_shell - v0.0.1alpha0

(dev_shell)
~/dev-shell$ ./dev-shell.py --update

To update existing virtualenv, call with --update:

~/dev-shell$ ./dev-shell.py --update

Or just delete /.venv/ and start dev-shell.py ;)

compatibility

See also github test configuration: .github/workflows/test.yml

History

• dev
  • TBC
• v0.1.0 - 2021-03-22
  • Fix CI usage: Exit with correct return code if tests failed
  • Better "run as CLI" implementation via new run_cmd2_app()
  • Bugfix errors that only occur on Windows.
  • Simplify dev-shell.py boot script and fix raise error if ensurepip missing
• v0.0.2 - 2021-03-19
  • refactor colorful shortcuts
  • display subprocess calls with separated colors
• v0.0.1 - 2021-03-19
  • first "useable" version

Project links

• Github: https://github.com/jedie/dev-shell/
• PyPi: https://pypi-hypernode.com/project/dev-shell/