https://github.com/franneck94/pythonprojecttemplate

Python project template with unit-tests, documentation, ci-testing and workflows.
https://github.com/franneck94/pythonprojecttemplate

benchmark codecov conda github-actions makefile pre-commit pytest python setuptools sphinx testing travis-ci vscode workflows

Last synced: 10 months ago
JSON representation

Python project template with unit-tests, documentation, ci-testing and workflows.

• Host: GitHub
• URL: https://github.com/franneck94/pythonprojecttemplate
• Owner: franneck94
• License: mit
• Created: 2020-07-11T10:03:53.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-04-22T05:31:40.000Z (almost 2 years ago)
• Last Synced: 2025-03-16T00:23:02.661Z (10 months ago)
• Topics: benchmark, codecov, conda, github-actions, makefile, pre-commit, pytest, python, setuptools, sphinx, testing, travis-ci, vscode, workflows
• Language: Python
• Homepage:
• Size: 637 KB
• Stars: 63
• Watchers: 5
• Forks: 55
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# FastVector

![Python](https://img.shields.io/badge/python-3.9+-blue)

![License](https://camo.githubusercontent.com/890acbdcb87868b382af9a4b1fac507b9659d9bf/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)

[![Build](https://github.com/franneck94/Python-Project-Template/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/franneck94/Python-Project-Template/actions/workflows/test.yml)

[![codecov](https://codecov.io/gh/franneck94/Python-Project-Template-Eng/branch/master/graph/badge.svg)](https://codecov.io/gh/franneck94/Python-Project-Template-Eng)

[![Documentation](https://img.shields.io/badge/ref-Documentation-blue)](https://franneck94.github.io/Python-Project-Template-Eng/)

## Template For Python Projects

This is a template for Python projects. What you get:

- Source code and test code is seperated in different directories.

- External libraries installed and managed by [Pip](https://pypi.org/project/pip/) and [setuptools](https://setuptools.pypa.io/en/latest/) in a pyproject.toml.

- Setup for tests using [Pytest](https://docs.pytest.org/en/stable/) and coverage with [Pytest-Cov](https://github.com/pytest-dev/pytest-cov).

- Continuous testing with [Github-Actions](https://github.com/features/actions/) including [pre-commit](https://github.com/pre-commit/pre-commit).

- Code coverage reports, including automatic upload to [Codecov](https://codecov.io).

- Code documentation with [Mkdocs](https://www.mkdocs.org/).

## Structure

``` text

├── pyproject.toml

├── ... other config files ...

├── docs

│   ├── api.md

│   └── index.md

├── examples

│   └── ...

├── fastvector

│   ├── __init__.py

│   ├── vector.py

│   └── version.py

└── tests

    ├── __init__.py

    └── test_vector.py

```

### Commands

```bash

# Build and Install (local)

pip install -e .  # OR

pip install -e ../Python-Project-Template  # OR

pip install -e ../Python-Project-Template[all]

```

```bash

# Test

pytest tests  # OR

pytest .  # OR

pytest

```

```bash

# Code Coverage

pytest --cov=fastvector tests --cov-report=html

```