A cookie cutter is a template for creating a new project. This cookie cutter will be used to create a new Python project with all of the development tools and initial code preconfigured and ready for use with Visual Studio Code.
To use this Cookie Cutter you will need Python and the Cookie Cutter package installed. Also, the files created with the Cookie Cutter project template are designed to work with
-
Download the Windows Installer for Python from python.org
-
On the first page of the installation wizard, check the box to add Python to the path. This will make it easier to run Python from the command prompt.
-
Complete the install as normal.
-
Install Homebrew from brew.sh
-
Then, run:
brew install python
- To verify the Python installation, run the following command:
python -V
Ensure it outputs the version you just installed.
- If the version displayed is different from the version installed the most likely you will need to adjust your system paths to resolve to the new Python path. Configuring path environment variables is outside the scope of this document.
With Python installed, let's ensure we have the latest PIP package manager.
python -m pip install --upgrade pip setuptools wheel
With PIP upgraded, now the Cookie Cutter package needs to be installed. From a terminal window, run the following command:
python -m pip install cookiecutter
-
From a terminal window, change to the folder where you would like to store your new project.
-
To create the new project, run the following command:
cookiecutter https://github.com/t4d-starter-projects/cookiecutter-create-python-project
-
It will prompt you for a project name, type in a name. I recommended something with no spaces, allow lower case, and no special characters except for an underscore.
-
A new folder is created with the project name. The contents of the cookie cutter project template are copied into the folder.
-
First, ensure you have Visual Studio Code installed. It can be downloaded from here code.visualstudio.com.
-
Install the Python extension for Visual Studio Code.
-
Start Visual Studio Code, and open the project folder created by Cookie Cutter.
-
Open a terminal window. Within the terminal session verify you are in the folder with the "requirements.txt" file.
-
Create a new virtual environment.
python -m venv venv
Note: On systems where you have Python 2 installed along with Python 3 you may need to use the python3
command instead of the plain python
command for this one step.
-
When the environment is created Visual Studio Code should detect it and asked you if you want to make this virtual environment the Python interpreter in Visual Studio, click "Yes".
-
Activate the environment in the terminal window.
Windows with PowerShell
.\venv\Scripts\Activate.ps1
macOS, Linux, Bash/Zsh Shell
source ./venv/bin/activate
- Upgrade PIP for the virtual environment.
python -m pip install --upgrade pip setuptools wheel
- Install the packages listed in the
requirements.txt
file.
python -m pip install -r requirements.txt
- Congrats! You are all done!
To run the project in various ways, here are the commands:
Run the Main Module
python -m {{cookiecutter.package_name}}
Run the Pylint Linter
python -m pylint --max-line-length=79 --unsafe-load-any-extension=y --ignore=.git,venv,.vscode,__pycache__ {{cookiecutter.package_name}} tests
Run the Flake8 Linter
python -m flake8 --exclude=venv,.git,__pycache__
Run the MyPy Linter
python -m mypy --ignore-missing-imports --follow-imports=silent --show-column-numbers --strict --exclude venv .
Run the Unit Tests with Code Coverage
python -m coverage run -m unittest tests.__main__
Generate Code Coverage Report
python -m coverage report --omit="venv/*,tests/*,setup.py"
- Included is an Azure Pipeline file that will validate the source code per the linting rules and run unit tests and code coverage when committed code to Azure Repos.