https://github.com/ankandrew/python-project-template

Modern Python Project Template
https://github.com/ankandrew/python-project-template

cookiecutter-python project-template python-project python-project-template python-repositories python-template

Last synced: 9 days ago
JSON representation

Modern Python Project Template

• Host: GitHub
• URL: https://github.com/ankandrew/python-project-template
• Owner: ankandrew
• Created: 2023-09-13T00:56:23.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-06-18T03:23:59.000Z (9 months ago)
• Last Synced: 2025-07-27T14:58:14.927Z (8 months ago)
• Topics: cookiecutter-python, project-template, python-project, python-project-template, python-repositories, python-template
• Language: Makefile
• Homepage:
• Size: 83 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          

  * [Development](#development)

    * [Prerequisites](#prerequisites)

    * [Installation](#installation)

# Python Project Template

![example workflow](https://github.com/ankandrew/python-project-template/actions/workflows/ci.yaml/badge.svg)

[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

[![Pylint](https://img.shields.io/badge/linting-pylint-yellowgreen)](https://github.com/pylint-dev/pylint)

[![Checked with mypy](http://www.mypy-lang.org/static/mypy_badge.svg)](http://mypy-lang.org/)

A modern Python project template with `uv`, Ruff, Pylint, mypy, pytest, and GitHub Actions preconfigured.

## Development

A quick setup for local development using [uv](https://github.com/astral-sh/uv).

### Prerequisites

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

### Installation

```bash

# Install Python if needed

uv python install 3.10

# Install the project and development dependencies

make install

# Run checks

make lint

make test

```

Replace the remaining `TODO` placeholders with project-specific values before publishing.