crowbar-package-manager 0.1.12

a local-first tool for managing python dependencies with pip

crowbar

Note: any instance of crowbar can be replaced with cb

crowbar install <package_name> <package_name>

-Checks to see if there is an environment folder based on the name you've set (venv is the default) in the current directory or in directories above -Creates a virtual environment called venv if it does not exist
-Installs a package (or packages) from pypi into venv
-Updates requirements.txt and creates one if it does not exist

crowbar uninstall <package_name> <package_name>

-Uninstalls a package (or packages) from venv -Updates requirements.txt

crowbar install

-Installs all packages listed in requirements.txt

crowbar run <file_name>.py

-Runs a python file using the contents of the local venv

crowbar show name

-Lists the current name of the environment folder that crowbar creates (venv is the default)

crowbar name <environment name>

-Changes the name of the environment folder that crowbar creates (venv is the default)

crowbar check env

-Checks to see if there is an environment folder based on the name you've set (venv is the default) in the current directory or in directories above

crowbar create env

-Creates an environment folder in the current directory based on the name you've set (venv is the default)

crowbar show gitignore

-Indicates whether Crowbar is set to create a .gitignore file when it creates an environment folder (default is not to create .gitignore)

crowbar gitignore on

-Instructs Crowbar to create a .gitignore file when it creates an environment folder and add the name of that folder to the .gitignore file

crowbar gitignore off

-Instructs Crowbar not to create a .gitignore file when it creates an environment folder (this is the default)

Warning – you may have pip muscle memory which may cause you to accidentally install globally. Use crowbar/cb and not pip if you are not in an active virtual environment.

global flag

crowbar --global install <package_name>

cb -g uninstall <package_name>

-installs or uninstalls a package globally

running package commands

With the crowbar command you can run any commands installed in the virtual environment.

Example - starting a new Django project:

cb django-admin startproject django_project .

Use crowbar run to run any commands surfaced by files within your Python program.

Example - running the Django development server:

cb run manage.py runserver

package managers other than pip

Crowbar does not support Conda. Crowbar has plans to support UV eventually.