Name | python-template-x JSON |
Version |
0.2.2
JSON |
| download |
home_page | |
Summary | This is a python template. |
upload_time | 2024-03-07 04:52:49 |
maintainer | |
docs_url | None |
author | Mark Beacom |
requires_python | >=3.8,<4.0 |
license | MIT |
keywords |
app
cli
python
template
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# python-template
[![Validation Workflow](https://github.com/mbeacom/python-template/actions/workflows/validate.yaml/badge.svg?branch=main&event=push)](https://github.com/mbeacom/python-template/actions/workflows/validate.yaml)
[![Pre-Commit Checks Workflow](https://github.com/mbeacom/python-template/actions/workflows/pre-commit.yaml/badge.svg?branch=main&event=push)](https://github.com/mbeacom/python-template/actions/workflows/pre-commit.yaml)
[![Coverage Status](https://codecov.io/github/mbeacom/python-template/coverage.svg?branch=main)](https://codecov.io/github/mbeacom/python-template?branch=main)
[![PyPi](https://img.shields.io/pypi/v/python-template-x)](https://pypi.org/project/python-template-x/)
[![CodeQL](https://github.com/mbeacom/python-template/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/mbeacom/python-template/actions/workflows/github-code-scanning/codeql)
[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/mbeacom/python-template/badge)](https://securityscorecards.dev/viewer/?uri=github.com/mbeacom/python-template)
This project is an opinionated python template.
## Usage
This project uses:
- [poetry](https://python-poetry.org/) for dependency management and packaging.
- [poethepoet](https://poethepoet.natn.io/) for task running.
- [pytest](https://docs.pytest.org/en/stable/) for testing.
- [black](https://black.readthedocs.io/en/stable/) for auto-formatting.
- [mypy](https://mypy.readthedocs.io/en/stable/) for static type checking.
- [pre-commit](https://pre-commit.com/) for git hooks.
- [ruff](https://beta.ruff.rs/docs/) for linting.
- [mkdocs](https://www.mkdocs.org/) for documentation.
Ensure you have installed the relevant dependencies before continuing.
### Install dependencies
```bash
poetry install
```
### Run tests
```bash
poetry run poe test
```
## GitHub Actions Setup
### Validation Workflow
#### CodeCov.io
The workflow is automatically setup to pass along coverage reports to CodeCov.io.
You must set the `CODECOV_TOKEN` secret in your repository settings.
Otherwise, disable the routine in the `.github/workflows/validate.yaml` file.
### Publishing Workflow
Ensure you have Discussions enabled in your repository settings,
or remove `discussion_category_name` from the `.github/workflows/publish.yaml` file.
#### PyPi
The workflow is automatically setup to publish to PyPi.
You must set the `POETRY_PYPI_TOKEN_PYPI` secret in your repository settings.
Otherwise, disable the routine in the `.github/workflows/publish.yaml` file.
Raw data
{
"_id": null,
"home_page": "",
"name": "python-template-x",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<4.0",
"maintainer_email": "",
"keywords": "app,cli,python,template",
"author": "Mark Beacom",
"author_email": "m@beacom.dev",
"download_url": "https://files.pythonhosted.org/packages/76/3e/fa575576424f9952ec1f6af70c2e3260516c5f7d8c6691eac488a43e298d/python_template_x-0.2.2.tar.gz",
"platform": null,
"description": "# python-template\n\n[![Validation Workflow](https://github.com/mbeacom/python-template/actions/workflows/validate.yaml/badge.svg?branch=main&event=push)](https://github.com/mbeacom/python-template/actions/workflows/validate.yaml)\n[![Pre-Commit Checks Workflow](https://github.com/mbeacom/python-template/actions/workflows/pre-commit.yaml/badge.svg?branch=main&event=push)](https://github.com/mbeacom/python-template/actions/workflows/pre-commit.yaml)\n[![Coverage Status](https://codecov.io/github/mbeacom/python-template/coverage.svg?branch=main)](https://codecov.io/github/mbeacom/python-template?branch=main)\n[![PyPi](https://img.shields.io/pypi/v/python-template-x)](https://pypi.org/project/python-template-x/)\n[![CodeQL](https://github.com/mbeacom/python-template/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/mbeacom/python-template/actions/workflows/github-code-scanning/codeql)\n[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/mbeacom/python-template/badge)](https://securityscorecards.dev/viewer/?uri=github.com/mbeacom/python-template)\n\nThis project is an opinionated python template.\n\n## Usage\n\nThis project uses:\n\n- [poetry](https://python-poetry.org/) for dependency management and packaging.\n- [poethepoet](https://poethepoet.natn.io/) for task running.\n- [pytest](https://docs.pytest.org/en/stable/) for testing.\n- [black](https://black.readthedocs.io/en/stable/) for auto-formatting.\n- [mypy](https://mypy.readthedocs.io/en/stable/) for static type checking.\n- [pre-commit](https://pre-commit.com/) for git hooks.\n- [ruff](https://beta.ruff.rs/docs/) for linting.\n- [mkdocs](https://www.mkdocs.org/) for documentation.\n\nEnsure you have installed the relevant dependencies before continuing.\n\n### Install dependencies\n\n```bash\npoetry install\n```\n\n### Run tests\n\n```bash\npoetry run poe test\n```\n\n## GitHub Actions Setup\n\n### Validation Workflow\n\n#### CodeCov.io\n\nThe workflow is automatically setup to pass along coverage reports to CodeCov.io.\nYou must set the `CODECOV_TOKEN` secret in your repository settings.\nOtherwise, disable the routine in the `.github/workflows/validate.yaml` file.\n\n### Publishing Workflow\n\nEnsure you have Discussions enabled in your repository settings,\nor remove `discussion_category_name` from the `.github/workflows/publish.yaml` file.\n\n#### PyPi\n\nThe workflow is automatically setup to publish to PyPi.\nYou must set the `POETRY_PYPI_TOKEN_PYPI` secret in your repository settings.\nOtherwise, disable the routine in the `.github/workflows/publish.yaml` file.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "This is a python template.",
"version": "0.2.2",
"project_urls": null,
"split_keywords": [
"app",
"cli",
"python",
"template"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b2271ea3d48bb730fda8ae08d6c3c807470beb2882b324a16a2f200b9061b479",
"md5": "9421dea40c2bf6cba3e27bcc39352ac2",
"sha256": "f91b79156b54247ede377fcdaee8d1b05048add5a5438876e90fe5c31ce4b1bf"
},
"downloads": -1,
"filename": "python_template_x-0.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9421dea40c2bf6cba3e27bcc39352ac2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<4.0",
"size": 5973,
"upload_time": "2024-03-07T04:52:49",
"upload_time_iso_8601": "2024-03-07T04:52:49.017226Z",
"url": "https://files.pythonhosted.org/packages/b2/27/1ea3d48bb730fda8ae08d6c3c807470beb2882b324a16a2f200b9061b479/python_template_x-0.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "763efa575576424f9952ec1f6af70c2e3260516c5f7d8c6691eac488a43e298d",
"md5": "885fe24812c85bf288c9bc1bba22a4ed",
"sha256": "944994045ce47960c17298927ef9271e54942e43ca1229642749b4c1d59feb9b"
},
"downloads": -1,
"filename": "python_template_x-0.2.2.tar.gz",
"has_sig": false,
"md5_digest": "885fe24812c85bf288c9bc1bba22a4ed",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<4.0",
"size": 4825,
"upload_time": "2024-03-07T04:52:49",
"upload_time_iso_8601": "2024-03-07T04:52:49.998411Z",
"url": "https://files.pythonhosted.org/packages/76/3e/fa575576424f9952ec1f6af70c2e3260516c5f7d8c6691eac488a43e298d/python_template_x-0.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-07 04:52:49",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "python-template-x"
}