Skip to content

Packages

Snok is great for scaffolding out initial, un-opinionated structure for your python package.

Getting ready

First set up your local environment by creating a directory and activating a virtual environment:

Assuming you have python 3.11+ installed:

cd $HOME/Desktop
mkdir -p mypackage && cd mypackage
python -m venv .venv
source .venv/bin/activate

You should see the path to your virtual environment now:

$ which python pip
/Users/anthony/Desktop/mypackage/.venv/bin/python
/Users/anthony/Desktop/mypackage/.venv/bin/pip

Installing Snok

Install Snok with pip:

pip install snok

Check that snok was installed:

snok

If you're using pyenv (recommended), you may have to rehash your shims

pyenv rehash

Creating a new package

Create a new package with:

snok new mypackage

Check that everything's ready to go!

snok ok

Now you're ready to start building your package!