https://github.com/ks6088ts/template-python

A GitHub template repository for Python
https://github.com/ks6088ts/template-python

black poetry pytest ruff trivy

Last synced: about 2 months ago
JSON representation

A GitHub template repository for Python

• Host: GitHub
• URL: https://github.com/ks6088ts/template-python
• Owner: ks6088ts
• License: mit
• Created: 2024-03-14T00:55:59.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2025-01-04T20:57:45.000Z (about 2 months ago)
• Last Synced: 2025-01-04T21:29:51.312Z (about 2 months ago)
• Topics: black, poetry, pytest, ruff, trivy
• Language: Makefile
• Homepage: https://ks6088ts.github.io/template-python/
• Size: 1.02 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![test](https://github.com/ks6088ts/template-python/actions/workflows/test.yaml/badge.svg?branch=main)](https://github.com/ks6088ts/template-python/actions/workflows/test.yaml?query=branch%3Amain)

[![docker](https://github.com/ks6088ts/template-python/actions/workflows/docker.yaml/badge.svg?branch=main)](https://github.com/ks6088ts/template-python/actions/workflows/docker.yaml?query=branch%3Amain)

[![docker-release](https://github.com/ks6088ts/template-python/actions/workflows/docker-release.yaml/badge.svg)](https://github.com/ks6088ts/template-python/actions/workflows/docker-release.yaml)

[![ghcr-release](https://github.com/ks6088ts/template-python/actions/workflows/ghcr-release.yaml/badge.svg)](https://github.com/ks6088ts/template-python/actions/workflows/ghcr-release.yaml)

[![docs](https://github.com/ks6088ts/template-python/actions/workflows/github-pages.yaml/badge.svg)](https://github.com/ks6088ts/template-python/actions/workflows/github-pages.yaml)

# template-python

This is a template repository for Python

## Prerequisites

- [Python 3.10+](https://www.python.org/downloads/)

- [uv](https://docs.astral.sh/uv/getting-started/installation/)

- [GNU Make](https://www.gnu.org/software/make/)

## Development instructions

### Local development

Use Makefile to run the project locally.

```shell

# help

make

# install dependencies for development

make install-deps-dev

# run tests

make test

# run CI tests

make ci-test

```

### Docker development

```shell

# build docker image

make docker-build

# run docker container

make docker-run

# run CI tests in docker container

make ci-test-docker

```

## Deployment instructions

### Docker Hub

To publish the docker image to Docker Hub, you need to [create access token](https://app.docker.com/settings/personal-access-tokens/create) and set the following secrets in the repository settings.

```shell

gh secret set DOCKERHUB_USERNAME --body $DOCKERHUB_USERNAME

gh secret set DOCKERHUB_TOKEN --body $DOCKERHUB_TOKEN

```