oe-python-template 0.6.24__py3-none-any.whl → 0.6.26__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {oe_python_template-0.6.24.dist-info → oe_python_template-0.6.26.dist-info}/METADATA +54 -52
- {oe_python_template-0.6.24.dist-info → oe_python_template-0.6.26.dist-info}/RECORD +5 -5
- {oe_python_template-0.6.24.dist-info → oe_python_template-0.6.26.dist-info}/WHEEL +0 -0
- {oe_python_template-0.6.24.dist-info → oe_python_template-0.6.26.dist-info}/entry_points.txt +0 -0
- {oe_python_template-0.6.24.dist-info → oe_python_template-0.6.26.dist-info}/licenses/LICENSE +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: oe-python-template
|
|
3
|
-
Version: 0.6.
|
|
3
|
+
Version: 0.6.26
|
|
4
4
|
Summary: 🧠 Copier template to scaffold Python projects compliant with best practices and modern tooling.
|
|
5
5
|
Project-URL: Homepage, https://oe-python-template.readthedocs.io/en/latest/
|
|
6
6
|
Project-URL: Documentation, https://oe-python-template.readthedocs.io/en/latest/
|
|
@@ -107,38 +107,40 @@ This [Copier](https://copier.readthedocs.io/en/stable/) template enables you to
|
|
|
107
107
|
Projects generated from this template can be [easily updated](https://copier.readthedocs.io/en/stable/updating/) to benefit from improvements and new features of the template.
|
|
108
108
|
|
|
109
109
|
Features:
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
110
|
+
1. Package management with [uv](https://github.com/astral-sh/uv)
|
|
111
|
+
2. Code formatting with [Ruff](https://github.com/astral-sh/ruff)
|
|
112
|
+
3. Linting with [Ruff](https://github.com/astral-sh/ruff)
|
|
113
|
+
4. Static type checking with [mypy](https://mypy.readthedocs.io/en/stable/)
|
|
114
|
+
5. Complete set of [pre-commit](https://pre-commit.com/) hooks including [detect-secrets](https://github.com/Yelp/detect-secrets) and [pygrep](https://github.com/pre-commit/pygrep-hooks)
|
|
115
|
+
6. Unit and E2E testing with [pytest](https://docs.pytest.org/en/stable/) including parallel test execution
|
|
116
|
+
7. Matrix testing in multiple environments with [nox](https://nox.thea.codes/en/stable/)
|
|
117
|
+
8. Test coverage reported with [Codecov](https://codecov.io/) and published as release artifact
|
|
118
|
+
9. CI/CD pipeline automated with [GitHub Actions](https://github.com/features/actions)
|
|
119
|
+
10. CI/CD pipeline can be run locally with [act](https://github.com/nektos/act)
|
|
120
|
+
11. Code quality and security checks with [SonarQube](https://www.sonarsource.com/products/sonarcloud) and [GitHub CodeQL](https://codeql.github.com/)
|
|
121
|
+
12. Dependency monitoring with [pip-audit](https://pypi.org/project/pip-audit/), [Renovate](https://github.com/renovatebot/renovate), and [GitHub Dependabot](https://docs.github.com/en/code-security/getting-started/dependabot-quickstart-guide)
|
|
122
|
+
13. Licenses of dependencies extracted with [pip-licenses](https://pypi.org/project/pip-licenses/) and published as release artifacts in CSV and JSON format for compliance checks
|
|
123
|
+
14. Software Bill of Materials (SBOM) generated with [cyclonedx-python](https://github.com/CycloneDX/cyclonedx-python) and published as release artifact
|
|
124
|
+
15. Version and release management with [bump-my-version](https://callowayproject.github.io/bump-my-version/)
|
|
125
|
+
16. Changelog and release notes generated with [git-cliff](https://git-cliff.org/)
|
|
126
|
+
17. Documentation generated with [Sphinx](https://www.sphinx-doc.org/en/master/) including reference documentation and PDF export
|
|
127
|
+
18. Documentation published to [Read The Docs](https://readthedocs.org/)
|
|
128
|
+
19. Interactive OpenAPI specification with [Swagger](https://swagger.io/)
|
|
129
|
+
20. Python package published to [PyPI](https://pypi.org/)
|
|
130
|
+
21. Docker images published to [Docker.io](https://hub.docker.com/) and [GitHub Container Registry](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry) with [artifact attestations](https://docs.github.com/en/actions/security-for-github-actions/using-artifact-attestations/using-artifact-attestations-to-establish-provenance-for-builds)
|
|
131
|
+
22. One-click development environments with [Dev Containers](https://code.visualstudio.com/docs/devcontainers/containers) and [GitHub Codespaces](https://github.com/features/codespaces)
|
|
132
|
+
23. Settings for use with [VSCode](https://code.visualstudio.com/)
|
|
133
|
+
24. Settings and custom instructions for use with [GitHub Copilot](https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot)
|
|
132
134
|
|
|
133
135
|
The generated project includes code, documentation and configuration of a fully functioning demo-application and service, which can be used as a starting point for your own project.
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
136
|
+
1. Service architecture suitable for use as shared library
|
|
137
|
+
2. Validation with [pydantic](https://docs.pydantic.dev/)
|
|
138
|
+
3. Command-line interface (CLI) with [Typer](https://typer.tiangolo.com/)
|
|
139
|
+
4. Versioned Web API with [FastAPI](https://fastapi.tiangolo.com/)
|
|
140
|
+
5. [Interactive Jupyter notebook](https://jupyter.org/) and [reactive Marimo notebook](https://marimo.io/)
|
|
141
|
+
6. Simple Web UI with [Streamlit](https://streamlit.io/)
|
|
142
|
+
7. Configuration to run the CLI and API in a Docker container including setup for [Docker Compose](https://docs.docker.com/get-started/docker-concepts/the-basics/what-is-docker-compose/)
|
|
143
|
+
8. Documentation including badges, setup instructions, contribution guide and security policy
|
|
142
144
|
|
|
143
145
|
Explore [here](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example) for what's generated out of the box.
|
|
144
146
|
|
|
@@ -187,9 +189,9 @@ external services such as CloudCov, SonarQube Cloud, Read The Docs, Docker.io, a
|
|
|
187
189
|
./n bump
|
|
188
190
|
```
|
|
189
191
|
Notes:
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
192
|
+
1. You can remove this section post having successfully generated your project.
|
|
193
|
+
2. The following sections refer to the dummy application and service provided by this template.
|
|
194
|
+
Use them as inspiration and adapt them to your own project.
|
|
193
195
|
|
|
194
196
|
## Overview
|
|
195
197
|
|
|
@@ -215,9 +217,9 @@ uvx oe-python-template serve --port=4711 # serves web API on port 4711
|
|
|
215
217
|
```
|
|
216
218
|
|
|
217
219
|
Notes:
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
220
|
+
1. The API is versioned, mounted at `/api/v1` resp. `/api/v2`
|
|
221
|
+
2. While serving the web API go to [http://127.0.0.1:8000/api/v1/hello-world](http://127.0.0.1:8000/api/v1/hello-world) to see the respons of the `hello-world` operation.
|
|
222
|
+
3. Interactive documentation is provided at [http://127.0.0.1:8000/api/docs](http://127.0.0.1:8000/api/docs)
|
|
221
223
|
|
|
222
224
|
|
|
223
225
|
The CLI provides extensive help:
|
|
@@ -235,21 +237,21 @@ uvx oe-python-template serve --help
|
|
|
235
237
|
|
|
236
238
|
This project is designed with operational excellence in mind, using modern Python tooling and practices. It includes:
|
|
237
239
|
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
240
|
+
1. Various examples demonstrating usage:
|
|
241
|
+
a. [Simple Python script](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/blob/main/examples/script.py)
|
|
242
|
+
b. [Streamlit web application](https://oe-python-template.streamlit.app/) deployed on [Streamlit Community Cloud](https://streamlit.io/cloud)
|
|
243
|
+
c. [Jupyter](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/blob/main/examples/notebook.ipynb) and [Marimo](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/blob/main/examples/notebook.py) notebook
|
|
244
|
+
2. [Complete reference documentation](https://oe-python-template.readthedocs.io/en/latest/reference.html) on Read the Docs
|
|
245
|
+
3. [Transparent test coverage](https://app.codecov.io/gh/helmut-hoffer-von-ankershoffen/oe-python-template) including unit and E2E tests (reported on Codecov)
|
|
246
|
+
4. Matrix tested with [multiple python versions](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/blob/main/noxfile.py) to ensure compatibility (powered by [Nox](https://nox.thea.codes/en/stable/))
|
|
247
|
+
5. Compliant with modern linting and formatting standards (powered by [Ruff](https://github.com/astral-sh/ruff))
|
|
248
|
+
6. Up-to-date dependencies (monitored by [Renovate](https://github.com/renovatebot/renovate) and [Dependabot](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/security/dependabot))
|
|
249
|
+
7. [A-grade code quality](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_oe-python-template) in security, maintainability, and reliability with low technical debt and codesmell (verified by SonarQube)
|
|
250
|
+
8. Additional code security checks using [CodeQL](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/security/code-scanning)
|
|
251
|
+
9. [Security Policy](SECURITY.md)
|
|
252
|
+
10. [License](LICENSE) compliant with the Open Source Initiative (OSI)
|
|
253
|
+
11. 1-liner for installation and execution of command line interface (CLI) via [uv(x)](https://github.com/astral-sh/uv) or [Docker](https://hub.docker.com/r/helmuthva/oe-python-template/tags)
|
|
254
|
+
12. Setup for developing inside a [devcontainer](https://code.visualstudio.com/docs/devcontainers/containers) included (supports VSCode and GitHub Codespaces)
|
|
253
255
|
|
|
254
256
|
|
|
255
257
|
## Usage Examples
|
|
@@ -3,8 +3,8 @@ oe_python_template/api.py,sha256=-7d4cLPHmdLZSkzu6UOaCp9hUO0Aq8MNq8uEZuiW9Y4,625
|
|
|
3
3
|
oe_python_template/cli.py,sha256=jvIPeJzx9esff7-M5pBe2R3vvmpxRvxKIre1VOGndls,3426
|
|
4
4
|
oe_python_template/constants.py,sha256=Z1c06l5DeRuFxYVLHihHHTYvr8_Qh0nyzVKOe5X3ZNs,350
|
|
5
5
|
oe_python_template/service.py,sha256=Gd-B9IIZ1vB1uONVJHA65hPnfeYeKUIcnU3rZbU2lGs,744
|
|
6
|
-
oe_python_template-0.6.
|
|
7
|
-
oe_python_template-0.6.
|
|
8
|
-
oe_python_template-0.6.
|
|
9
|
-
oe_python_template-0.6.
|
|
10
|
-
oe_python_template-0.6.
|
|
6
|
+
oe_python_template-0.6.26.dist-info/METADATA,sha256=5VFxwH8YePThFA19LjHDOuBsEJZZl8uKbHwgL8i2_7Q,26647
|
|
7
|
+
oe_python_template-0.6.26.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
|
|
8
|
+
oe_python_template-0.6.26.dist-info/entry_points.txt,sha256=IroSSWhLGxus9rxcashkYQda39TTvf7LbUMYtOKXUBE,66
|
|
9
|
+
oe_python_template-0.6.26.dist-info/licenses/LICENSE,sha256=5H409K6xzz9U5eUaoAHQExNkoWJRlU0LEj6wL2QJ34s,1113
|
|
10
|
+
oe_python_template-0.6.26.dist-info/RECORD,,
|
|
File without changes
|
{oe_python_template-0.6.24.dist-info → oe_python_template-0.6.26.dist-info}/entry_points.txt
RENAMED
|
File without changes
|
{oe_python_template-0.6.24.dist-info → oe_python_template-0.6.26.dist-info}/licenses/LICENSE
RENAMED
|
File without changes
|