oe-python-template 0.6.22__tar.gz → 0.6.24__tar.gz

{oe_python_template-0.6.22 → oe_python_template-0.6.24}/.copier-answers.yml

@@ -1,4 +1,4 @@
-_commit: v0.6.21-1-g6baf50a
+_commit: v0.6.23-1-g8ec9bc9
 _src_path: .
 author_email: helmuthva@gmail.com
 author_github_username: helmut-hoffer-von-ankershoffen

{oe_python_template-0.6.22 → oe_python_template-0.6.24}/CHANGELOG.md

@@ -1,6 +1,20 @@
 [🧠 OE Python Template](https://oe-python-template.readthedocs.io/en/latest/)
 
-## [0.6.22](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/compare/v0.6.21..0.6.22) - 2025-03-19
+## [0.6.24](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/compare/v0.6.23..0.6.24) - 2025-03-20
+
+### 📚 Documentation
+
+- Refactor intro - ([46c9054](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/commit/46c905486d34f319b7c293c3f1fd82773bc1a8b0))
+
+
+## [0.6.23](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/compare/v0.6.22..v0.6.23) - 2025-03-20
+
+### 📚 Documentation
+
+- Refactor intro - ([7e30bd3](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/commit/7e30bd30a516c52c729615fa516e0b493cdf0213))
+
+
+## [0.6.22](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/compare/v0.6.21..v0.6.22) - 2025-03-19
 
 ### 📚 Documentation
 

{oe_python_template-0.6.22 → oe_python_template-0.6.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oe-python-template
-Version: 0.6.22
+Version: 0.6.24
 Summary: 🧠 Copier template to scaffold Python projects compliant with best practices and modern tooling.
 Project-URL: Homepage, https://oe-python-template.readthedocs.io/en/latest/
 Project-URL: Documentation, https://oe-python-template.readthedocs.io/en/latest/
@@ -103,24 +103,51 @@ Description-Content-Type: text/markdown
 
 Copier template to scaffold Python projects compliant with best practices and modern tooling.
 
-Use Cases:
-1) Fast and easy generation of Python projects from this template
-2) Seamless updates of projects when improvements to the template are released
-3) Generates a fully-functional Python package with test and build automation featuring
-   - Service architecture suiteable for use as shared library
-   - Command-line interface (CLI)
-   - Versioned Web API
-   - Integration examples with Notebooks and Dashboards
-   - Complete developer-tooling with formatting, linting, type checking etc.
-   - CI/CD pipeline for GitHub, PyPI, and Docker registries
-   - Unit and E2E tests including parallel and matrix-testing
-   - Release artifacts include SBOM, license information, and test coverage
-   - Auto-generated documentation published to Read The Docs
-   - Service integrations monitoring code quality, dependencies, and security
-
-## Scaffolding
-
-**Step 1**: Install uv package manager and copier
+This [Copier](https://copier.readthedocs.io/en/stable/) template enables you to quickly generate a Python package with fully functioning build and test automation.
+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.
+
+Features:
+- Package management with [uv](https://github.com/astral-sh/uv)
+- Code formatting with [Ruff](https://github.com/astral-sh/ruff)
+- Linting with [Ruff](https://github.com/astral-sh/ruff)
+- Static type checking with [mypy](https://mypy.readthedocs.io/en/stable/)
+- 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)
+- Unit and E2E testing with [pytest](https://docs.pytest.org/en/stable/) including parallel test execution
+- Matrix testing in multiple environments with [nox](https://nox.thea.codes/en/stable/)
+- Test coverage reported with [Codecov](https://codecov.io/) and published as release artifact
+- CI/CD pipeline automated with [GitHub Actions](https://github.com/features/actions)
+- CI/CD pipeline can be run locally with [act](https://github.com/nektos/act)
+- Code quality and security checks with [SonarQube](https://www.sonarsource.com/products/sonarcloud) and [GitHub CodeQL](https://codeql.github.com/)
+- 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)
+- 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
+- Software Bill of Materials (SBOM) generated with [cyclonedx-python](https://github.com/CycloneDX/cyclonedx-python) and published as release artifact
+- Version and release management with [bump-my-version](https://callowayproject.github.io/bump-my-version/)
+- Changelog and release notes generated with [git-cliff](https://git-cliff.org/)
+- Documentation generated with [Sphinx](https://www.sphinx-doc.org/en/master/) including reference documentation and PDF export
+- Documentation published to [Read The Docs](https://readthedocs.org/)
+- Interactive OpenAPI specification with [Swagger](https://swagger.io/)
+- Python package published to [PyPI](https://pypi.org/)
+- 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)
+- One-click development environments with [Dev Containers](https://code.visualstudio.com/docs/devcontainers/containers) and [GitHub Codespaces](https://github.com/features/codespaces)
+
+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.
+- Service architecture suitable for use as shared library
+- Validation with [pydantic](https://docs.pydantic.dev/)
+- Command-line interface (CLI) with [Typer](https://typer.tiangolo.com/)
+- Versioned Web API with [FastAPI](https://fastapi.tiangolo.com/)
+- [Interactive Jupyter notebook](https://jupyter.org/) and [reactive Marimo notebook](https://marimo.io/)
+- Simple Web UI with [Streamlit](https://streamlit.io/)
+- 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/)
+- Documentation including badges, setup instructions, contribution guide and security policy
+
+Explore [here](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example) for what's generated out of the box.
+
+## Generate a new project
+
+This template is designed to be used with the [copier](https://copier.readthedocs.io/en/stable/) project generator. It allows you to create a new project based on this template and customize it according to your needs.
+To generate a new project, follow these steps:
+
+**Step 1**: Install uv package manager and copier. Copy the following code into your terminal and execute it.
 ```shell
 if [[ "$OSTYPE" == "darwin"* ]]; then                 # Install dependencies for macOS X
   if ! command -v brew &> /dev/null; then             ## Install Homebrew if not present
@@ -136,32 +163,31 @@ fi
 uv tool install copier                                # Install copier as global tool
 ```
 
-**Step 2**: Now create an empty repository on GitHub, clone to your local machine, and change into it's directory.
+**Step 2**: [Create an empty repository on GitHub](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-new-repository), clone to your local machine, and change into it's directory.
 
-**Step 3**: Scaffold the project
+**Step 3**: Generate the project. Copy
 ```shell
 copier copy --trust gh:helmut-hoffer-von-ankershoffen/oe-python-template .
 ```
 
-**Step 4**: Perform initial commit and push
+**Step 4**: Perform initial commit and push. Copy the following code into your terminal and execute it.
 ```shell
 git add .
 git commit -m "feat: Initial commit"
 git push
 ```
 
-Visit your GitHub repository and check the Actions tab. The CI workflow should fail at the SonarQube step,
-as this external service is not yet configured for our new repository.
+Visit your GitHub repository and check the Actions tab. The CI workflow should already be running! The workflow will fail at the SonarQube step, as this external service is not yet configured for our new repository.
 
 **Step 5**: Follow the [instructions](SERVICE_CONNECTIONS.md) to wire up
-external services such as Cloudcov, SonarQube Cloud, Read The Docs, Docker.io, GHCR.io and Streamlit Community Cloud.
+external services such as CloudCov, SonarQube Cloud, Read The Docs, Docker.io, and Streamlit Community Cloud.
 
 **Step 6**: Release the first versions
 ```shell
 ./n bump
 ```
 Notes:
-* You can remove this section post having successfully scafolded your project.
+* You can remove this section post having successfully generated your project.
 * The following sections refer to the dummy application and service provided by this template.
   Use them as inspiration and adapt them to your own project.
 
@@ -217,9 +243,9 @@ This project is designed with operational excellence in mind, using modern Pytho
 * [Transparent test coverage](https://app.codecov.io/gh/helmut-hoffer-von-ankershoffen/oe-python-template) including unit and E2E tests (reported on Codecov)
 * 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/))
 * Compliant with modern linting and formatting standards (powered by [Ruff](https://github.com/astral-sh/ruff))
-* Up-to-date dependencies (monitored by [Renovate](https://github.com/renovatebot/renovate) and [GitHub Dependabot](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/security/dependabot))
+* 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))
 * [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)
-* Additional code security checks using [GitHub CodeQL](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/security/code-scanning)
+* Additional code security checks using [CodeQL](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/security/code-scanning)
 * [Security Policy](SECURITY.md)
 * [License](LICENSE) compliant with the Open Source Initiative (OSI)
 * 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)

{oe_python_template-0.6.22 → oe_python_template-0.6.24}/README.md

@@ -42,24 +42,51 @@
 
 Copier template to scaffold Python projects compliant with best practices and modern tooling.
 
-Use Cases:
-1) Fast and easy generation of Python projects from this template
-2) Seamless updates of projects when improvements to the template are released
-3) Generates a fully-functional Python package with test and build automation featuring
-   - Service architecture suiteable for use as shared library
-   - Command-line interface (CLI)
-   - Versioned Web API
-   - Integration examples with Notebooks and Dashboards
-   - Complete developer-tooling with formatting, linting, type checking etc.
-   - CI/CD pipeline for GitHub, PyPI, and Docker registries
-   - Unit and E2E tests including parallel and matrix-testing
-   - Release artifacts include SBOM, license information, and test coverage
-   - Auto-generated documentation published to Read The Docs
-   - Service integrations monitoring code quality, dependencies, and security
-
-## Scaffolding
-
-**Step 1**: Install uv package manager and copier
+This [Copier](https://copier.readthedocs.io/en/stable/) template enables you to quickly generate a Python package with fully functioning build and test automation.
+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.
+
+Features:
+- Package management with [uv](https://github.com/astral-sh/uv)
+- Code formatting with [Ruff](https://github.com/astral-sh/ruff)
+- Linting with [Ruff](https://github.com/astral-sh/ruff)
+- Static type checking with [mypy](https://mypy.readthedocs.io/en/stable/)
+- 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)
+- Unit and E2E testing with [pytest](https://docs.pytest.org/en/stable/) including parallel test execution
+- Matrix testing in multiple environments with [nox](https://nox.thea.codes/en/stable/)
+- Test coverage reported with [Codecov](https://codecov.io/) and published as release artifact
+- CI/CD pipeline automated with [GitHub Actions](https://github.com/features/actions)
+- CI/CD pipeline can be run locally with [act](https://github.com/nektos/act)
+- Code quality and security checks with [SonarQube](https://www.sonarsource.com/products/sonarcloud) and [GitHub CodeQL](https://codeql.github.com/)
+- 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)
+- 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
+- Software Bill of Materials (SBOM) generated with [cyclonedx-python](https://github.com/CycloneDX/cyclonedx-python) and published as release artifact
+- Version and release management with [bump-my-version](https://callowayproject.github.io/bump-my-version/)
+- Changelog and release notes generated with [git-cliff](https://git-cliff.org/)
+- Documentation generated with [Sphinx](https://www.sphinx-doc.org/en/master/) including reference documentation and PDF export
+- Documentation published to [Read The Docs](https://readthedocs.org/)
+- Interactive OpenAPI specification with [Swagger](https://swagger.io/)
+- Python package published to [PyPI](https://pypi.org/)
+- 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)
+- One-click development environments with [Dev Containers](https://code.visualstudio.com/docs/devcontainers/containers) and [GitHub Codespaces](https://github.com/features/codespaces)
+
+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.
+- Service architecture suitable for use as shared library
+- Validation with [pydantic](https://docs.pydantic.dev/)
+- Command-line interface (CLI) with [Typer](https://typer.tiangolo.com/)
+- Versioned Web API with [FastAPI](https://fastapi.tiangolo.com/)
+- [Interactive Jupyter notebook](https://jupyter.org/) and [reactive Marimo notebook](https://marimo.io/)
+- Simple Web UI with [Streamlit](https://streamlit.io/)
+- 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/)
+- Documentation including badges, setup instructions, contribution guide and security policy
+
+Explore [here](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example) for what's generated out of the box.
+
+## Generate a new project
+
+This template is designed to be used with the [copier](https://copier.readthedocs.io/en/stable/) project generator. It allows you to create a new project based on this template and customize it according to your needs.
+To generate a new project, follow these steps:
+
+**Step 1**: Install uv package manager and copier. Copy the following code into your terminal and execute it.
 ```shell
 if [[ "$OSTYPE" == "darwin"* ]]; then                 # Install dependencies for macOS X
   if ! command -v brew &> /dev/null; then             ## Install Homebrew if not present
@@ -75,32 +102,31 @@ fi
 uv tool install copier                                # Install copier as global tool
 ```
 
-**Step 2**: Now create an empty repository on GitHub, clone to your local machine, and change into it's directory.
+**Step 2**: [Create an empty repository on GitHub](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-new-repository), clone to your local machine, and change into it's directory.
 
-**Step 3**: Scaffold the project
+**Step 3**: Generate the project. Copy
 ```shell
 copier copy --trust gh:helmut-hoffer-von-ankershoffen/oe-python-template .
 ```
 
-**Step 4**: Perform initial commit and push
+**Step 4**: Perform initial commit and push. Copy the following code into your terminal and execute it.
 ```shell
 git add .
 git commit -m "feat: Initial commit"
 git push
 ```
 
-Visit your GitHub repository and check the Actions tab. The CI workflow should fail at the SonarQube step,
-as this external service is not yet configured for our new repository.
+Visit your GitHub repository and check the Actions tab. The CI workflow should already be running! The workflow will fail at the SonarQube step, as this external service is not yet configured for our new repository.
 
 **Step 5**: Follow the [instructions](SERVICE_CONNECTIONS.md) to wire up
-external services such as Cloudcov, SonarQube Cloud, Read The Docs, Docker.io, GHCR.io and Streamlit Community Cloud.
+external services such as CloudCov, SonarQube Cloud, Read The Docs, Docker.io, and Streamlit Community Cloud.
 
 **Step 6**: Release the first versions
 ```shell
 ./n bump
 ```
 Notes:
-* You can remove this section post having successfully scafolded your project.
+* You can remove this section post having successfully generated your project.
 * The following sections refer to the dummy application and service provided by this template.
   Use them as inspiration and adapt them to your own project.
 
@@ -156,9 +182,9 @@ This project is designed with operational excellence in mind, using modern Pytho
 * [Transparent test coverage](https://app.codecov.io/gh/helmut-hoffer-von-ankershoffen/oe-python-template) including unit and E2E tests (reported on Codecov)
 * 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/))
 * Compliant with modern linting and formatting standards (powered by [Ruff](https://github.com/astral-sh/ruff))
-* Up-to-date dependencies (monitored by [Renovate](https://github.com/renovatebot/renovate) and [GitHub Dependabot](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/security/dependabot))
+* 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))
 * [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)
-* Additional code security checks using [GitHub CodeQL](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/security/code-scanning)
+* Additional code security checks using [CodeQL](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/security/code-scanning)
 * [Security Policy](SECURITY.md)
 * [License](LICENSE) compliant with the Open Source Initiative (OSI)
 * 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)

oe_python_template-0.6.24/RELEASE_NOTES.md

@@ -0,0 +1,8 @@
+## [0.6.24](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/compare/v0.6.23..v0.6.24) - 2025-03-20
+
+### 📚 Documentation
+
+- Refactor intro - ([46c9054](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/commit/46c905486d34f319b7c293c3f1fd82773bc1a8b0))
+
+
+

oe_python_template-0.6.24/VERSION

@@ -0,0 +1 @@
+0.6.24

{oe_python_template-0.6.22 → oe_python_template-0.6.24}/docs/partials/README_main.md

@@ -1,23 +1,50 @@
 Copier template to scaffold Python projects compliant with best practices and modern tooling.
 
-Use Cases:
-1) Fast and easy generation of Python projects from this template
-2) Seamless updates of projects when improvements to the template are released
-3) Generates a fully-functional Python package with test and build automation featuring
-   - Service architecture suiteable for use as shared library
-   - Command-line interface (CLI)
-   - Versioned Web API
-   - Integration examples with Notebooks and Dashboards
-   - Complete developer-tooling with formatting, linting, type checking etc.
-   - CI/CD pipeline for GitHub, PyPI, and Docker registries
-   - Unit and E2E tests including parallel and matrix-testing
-   - Release artifacts include SBOM, license information, and test coverage
-   - Auto-generated documentation published to Read The Docs
-   - Service integrations monitoring code quality, dependencies, and security
-
-## Scaffolding
-
-**Step 1**: Install uv package manager and copier
+This [Copier](https://copier.readthedocs.io/en/stable/) template enables you to quickly generate a Python package with fully functioning build and test automation.
+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.
+
+Features:
+- Package management with [uv](https://github.com/astral-sh/uv)
+- Code formatting with [Ruff](https://github.com/astral-sh/ruff)
+- Linting with [Ruff](https://github.com/astral-sh/ruff)
+- Static type checking with [mypy](https://mypy.readthedocs.io/en/stable/)
+- 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)
+- Unit and E2E testing with [pytest](https://docs.pytest.org/en/stable/) including parallel test execution
+- Matrix testing in multiple environments with [nox](https://nox.thea.codes/en/stable/)
+- Test coverage reported with [Codecov](https://codecov.io/) and published as release artifact
+- CI/CD pipeline automated with [GitHub Actions](https://github.com/features/actions)
+- CI/CD pipeline can be run locally with [act](https://github.com/nektos/act)
+- Code quality and security checks with [SonarQube](https://www.sonarsource.com/products/sonarcloud) and [GitHub CodeQL](https://codeql.github.com/)
+- 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)
+- 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
+- Software Bill of Materials (SBOM) generated with [cyclonedx-python](https://github.com/CycloneDX/cyclonedx-python) and published as release artifact
+- Version and release management with [bump-my-version](https://callowayproject.github.io/bump-my-version/)
+- Changelog and release notes generated with [git-cliff](https://git-cliff.org/)
+- Documentation generated with [Sphinx](https://www.sphinx-doc.org/en/master/) including reference documentation and PDF export
+- Documentation published to [Read The Docs](https://readthedocs.org/)
+- Interactive OpenAPI specification with [Swagger](https://swagger.io/)
+- Python package published to [PyPI](https://pypi.org/)
+- 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)
+- One-click development environments with [Dev Containers](https://code.visualstudio.com/docs/devcontainers/containers) and [GitHub Codespaces](https://github.com/features/codespaces)
+
+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.
+- Service architecture suitable for use as shared library
+- Validation with [pydantic](https://docs.pydantic.dev/)
+- Command-line interface (CLI) with [Typer](https://typer.tiangolo.com/)
+- Versioned Web API with [FastAPI](https://fastapi.tiangolo.com/)
+- [Interactive Jupyter notebook](https://jupyter.org/) and [reactive Marimo notebook](https://marimo.io/)
+- Simple Web UI with [Streamlit](https://streamlit.io/)
+- 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/)
+- Documentation including badges, setup instructions, contribution guide and security policy
+
+Explore [here](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example) for what's generated out of the box.
+
+## Generate a new project
+
+This template is designed to be used with the [copier](https://copier.readthedocs.io/en/stable/) project generator. It allows you to create a new project based on this template and customize it according to your needs.
+To generate a new project, follow these steps:
+
+**Step 1**: Install uv package manager and copier. Copy the following code into your terminal and execute it.
 ```shell
 if [[ "$OSTYPE" == "darwin"* ]]; then                 # Install dependencies for macOS X
   if ! command -v brew &> /dev/null; then             ## Install Homebrew if not present
@@ -33,32 +60,31 @@ fi
 uv tool install copier                                # Install copier as global tool
 ```
 
-**Step 2**: Now create an empty repository on GitHub, clone to your local machine, and change into it's directory.
+**Step 2**: [Create an empty repository on GitHub](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-new-repository), clone to your local machine, and change into it's directory.
 
-**Step 3**: Scaffold the project
+**Step 3**: Generate the project. Copy
 ```shell
 copier copy --trust gh:helmut-hoffer-von-ankershoffen/oe-python-template .
 ```
 
-**Step 4**: Perform initial commit and push
+**Step 4**: Perform initial commit and push. Copy the following code into your terminal and execute it.
 ```shell
 git add .
 git commit -m "feat: Initial commit"
 git push
 ```
 
-Visit your GitHub repository and check the Actions tab. The CI workflow should fail at the SonarQube step,
-as this external service is not yet configured for our new repository.
+Visit your GitHub repository and check the Actions tab. The CI workflow should already be running! The workflow will fail at the SonarQube step, as this external service is not yet configured for our new repository.
 
 **Step 5**: Follow the [instructions](SERVICE_CONNECTIONS.md) to wire up
-external services such as Cloudcov, SonarQube Cloud, Read The Docs, Docker.io, GHCR.io and Streamlit Community Cloud.
+external services such as CloudCov, SonarQube Cloud, Read The Docs, Docker.io, and Streamlit Community Cloud.
 
 **Step 6**: Release the first versions
 ```shell
 ./n bump
 ```
 Notes:
-* You can remove this section post having successfully scafolded your project.
+* You can remove this section post having successfully generated your project.
 * The following sections refer to the dummy application and service provided by this template.
   Use them as inspiration and adapt them to your own project.
 
@@ -114,9 +140,9 @@ This project is designed with operational excellence in mind, using modern Pytho
 * [Transparent test coverage](https://app.codecov.io/gh/helmut-hoffer-von-ankershoffen/oe-python-template) including unit and E2E tests (reported on Codecov)
 * 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/))
 * Compliant with modern linting and formatting standards (powered by [Ruff](https://github.com/astral-sh/ruff))
-* Up-to-date dependencies (monitored by [Renovate](https://github.com/renovatebot/renovate) and [GitHub Dependabot](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/security/dependabot))
+* 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))
 * [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)
-* Additional code security checks using [GitHub CodeQL](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/security/code-scanning)
+* Additional code security checks using [CodeQL](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/security/code-scanning)
 * [Security Policy](SECURITY.md)
 * [License](LICENSE) compliant with the Open Source Initiative (OSI)
 * 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)

oe_python_template-0.6.24/docs/source/_static/openapi_v1.yaml

@@ -0,0 +1,188 @@
+components:
+  schemas:
+    EchoRequest:
+      description: Request model for echo endpoint.
+      properties:
+        text:
+          description: The text to echo back
+          examples:
+          - Hello, world!
+          minLength: 1
+          title: Text
+          type: string
+      required:
+      - text
+      title: EchoRequest
+      type: object
+    EchoResponse:
+      description: Response model for echo endpoint.
+      properties:
+        message:
+          description: The message content
+          examples:
+          - Hello, world!
+          minLength: 1
+          title: Message
+          type: string
+      required:
+      - message
+      title: EchoResponse
+      type: object
+    HTTPValidationError:
+      properties:
+        detail:
+          items:
+            $ref: '#/components/schemas/ValidationError'
+          title: Detail
+          type: array
+      title: HTTPValidationError
+      type: object
+    Health:
+      description: Health status model.
+      properties:
+        reason:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Reason
+        status:
+          $ref: '#/components/schemas/_HealthStatus'
+      required:
+      - status
+      title: Health
+      type: object
+    HelloWorldResponse:
+      description: Response model for hello-world endpoint.
+      properties:
+        message:
+          description: The hello world message
+          examples:
+          - Hello, world!
+          title: Message
+          type: string
+      required:
+      - message
+      title: HelloWorldResponse
+      type: object
+    ValidationError:
+      properties:
+        loc:
+          items:
+            anyOf:
+            - type: string
+            - type: integer
+          title: Location
+          type: array
+        msg:
+          title: Message
+          type: string
+        type:
+          title: Error Type
+          type: string
+      required:
+      - loc
+      - msg
+      - type
+      title: ValidationError
+      type: object
+    _HealthStatus:
+      description: Health status enumeration.
+      enum:
+      - UP
+      - DOWN
+      title: _HealthStatus
+      type: string
+info:
+  contact:
+    email: helmuthva@gmail.com
+    name: Helmut Hoffer von Ankershoffen
+    url: https://github.com/helmut-hoffer-von-ankershoffen
+  termsOfService: https://oe-python-template.readthedocs.io/en/latest/
+  title: OE Python Template
+  version: 1.0.0
+openapi: 3.1.0
+paths:
+  /echo:
+    post:
+      description: "Echo back the provided text.\n\nArgs:\n    request (EchoRequest):\
+        \ The request containing the text to echo back.\n\nReturns:\n    EchoResponse:\
+        \ A response containing the echoed text.\n\nRaises:\n    422 Unprocessable\
+        \ Entity: If text is not provided or empty."
+      operationId: echo_echo_post
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/EchoRequest'
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/EchoResponse'
+          description: Successful Response
+        '422':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      summary: Echo
+      tags:
+      - Basics
+  /health:
+    get:
+      description: "Check the health of the service.\n\nThis endpoint returns the\
+        \ health status of the service.\nThe health status can be either UP or DOWN.\n\
+        If the service is healthy, the status will be UP.\nIf the service is unhealthy,\
+        \ the status will be DOWN and a reason will be provided.\nThe response will\
+        \ have a 200 OK status code if the service is healthy,\nand a 500 Internal\
+        \ Server Error status code if the service is unhealthy.\n\nReturns:\n    Health:\
+        \ The health status of the service."
+      operationId: health_health_get
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Health'
+          description: Successful Response
+      summary: Health
+      tags:
+      - Observability
+  /healthz:
+    get:
+      description: "Check the health of the service.\n\nThis endpoint returns the\
+        \ health status of the service.\nThe health status can be either UP or DOWN.\n\
+        If the service is healthy, the status will be UP.\nIf the service is unhealthy,\
+        \ the status will be DOWN and a reason will be provided.\nThe response will\
+        \ have a 200 OK status code if the service is healthy,\nand a 500 Internal\
+        \ Server Error status code if the service is unhealthy.\n\nReturns:\n    Health:\
+        \ The health status of the service."
+      operationId: health_healthz_get
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Health'
+          description: Successful Response
+      summary: Health
+      tags:
+      - Observability
+  /hello-world:
+    get:
+      description: "Return a hello world message.\n\nReturns:\n    HelloWorldResponse:\
+        \ A response containing the hello world message."
+      operationId: hello_world_hello_world_get
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/HelloWorldResponse'
+          description: Successful Response
+      summary: Hello World
+      tags:
+      - Basics

{oe_python_template-0.6.22 → oe_python_template-0.6.24}/docs/source/conf.py

@@ -29,7 +29,7 @@ extensions = [
 project = "oe-python-template"
 author = "Helmut Hoffer von Ankershoffen"
 copyright = f" (c) 2025-{datetime.now(UTC).year}, {author}"  # noqa: A001
-version = "0.6.22"
+version = "0.6.24"
 release = version
 github_username = "helmut-hoffer-von-ankershoffen"
 github_repository = "oe-python-template"