Python Project Template

This is a Python project template that anyone can use with basic CI/CD pipeline, issue and PR templates etc.

Directory Structure

You can remove the (optional) directories if you don't need them. (e.g. docker/, setup.py, etc.)

python-project-template/    
├── .github/                # GA workflows & PR, Issue templates
├── docker/                 # (optional) Dockerfile & docker-compose files related to the project.  
├── tests/                  # Test codes with pytest
├── .gitignore              # gitignore file 
├── README.md               # README file
├── pyproject.toml          # (optional) PyPI package configuration file
├── setup.py                # (optional) PyPI package setup file
└── requirements.txt        # Project dependencies 

Github Actions

1. ci.yml

Basic CI workflow with pytest. It runs tests in the tests/ directory, with master branch commit & PR triggers by default.

2. publish-dockerhub.yml

Basic CD workflow for DockerHub publishing. You can remove this workflow if you don't need it.
It will build the docker image with files in the docker/ and publish it to the dockerhub. The auto-trigger of the action is disabled by default.
Before using the workflow, you need to set the DOCKER_USERNAME & DOCKER_PASSWORD in the repository settings.

And make sure to edit the image-name in the workflow.

python-project-template/.github/workflows/publish-dockerhub.yml

Lines 43 to 44 in 0c9dc95

	# Update with your image name
	tags: ${{ secrets.DOCKER_USERNAME }}/image-name:latest

3. publish-pypi.yml

Basic CD workflow for pypi package. You can remove this workflow if you don't need it.
The auto-trigger for this workflow is disabled by default. If enabled, it will build and publish to pypi whenever you make a new "release" in the repository.

Before using the workflow, edit package name to yours in the workflow.

python-project-template/.github/workflows/publish-pypi.yml

Lines 18 to 19 in 0c9dc95

	# Update URL with your package name
	url: https://pypi.org/p/package-name

Issue & PR Template

There are some basic templates for the issue & PR. You can edit them or add more to fit your project's needs.

• Issue Templates:

  1. bug_report.md : Basic bug report template
  2. feature_request.md : Feature request template

• PR Template: pull_request_template.md

Docker

The docker/ directory and publish-dockerhub.yml are associated with the Docker CI/CD pipeline. You can remove them if you don't need them.

Before building image, make sure to edit the variable in the docker/Dockerfile:

python-project-template/docker/Dockerfile

Lines 3 to 4 in 0c9dc95

	# Edit `PROJECT_NAME` with your project name.
	ARG PROJECT_NAME=your-project-name

And edit docker/docker-compose.yaml as well:

python-project-template/docker/docker-compose.yaml

Lines 6 to 7 in 0c9dc95

	# Edit image name to match your project
	image: your-name/project-name:latest

The image is built and published automatically by the CI/CD pipeline, but you can also manually build and run the image with the following commands.

1. git clone this repository

git clone https://github.com/your-name/your-project-name.git

2. Build the image

docker compose -f docker/docker-compose.yaml build

3. Run the container

docker compose -f docker/docker-compose.yaml up

PyPI

The setup.py, pyproject.toml and publish-pypi.yml are associated with the PyPI package CI/CD pipeline. You can remove them if you don't need them.

Make sure to edit dependencies & variables in the pyproject.toml as your project's needs.

How to start

Click "Use this template" and "Create a new repository". Then you can start your own project with git clone.