oe-python-template-example 0.0.9__tar.gz → 0.1.0__tar.gz

oe_python_template_example-0.0.9/.act-env → oe_python_template_example-0.1.0/.act-env-public

@@ -1,2 +1 @@
 GITHUB_WORKFLOW_RUNTIME=ACT
-ACTIONS_RUNTIME_TOKEN=TOKEN

{oe_python_template_example-0.0.9 → oe_python_template_example-0.1.0}/.copier-answers.yml

@@ -1,4 +1,4 @@
-_commit: v0.3.6
+_commit: v0.4.2
 _src_path: gh:helmut-hoffer-von-ankershoffen/oe-python-template
 author_email: helmuthva@gmail.com
 author_github_username: helmut-hoffer-von-ankershoffen

{oe_python_template_example-0.0.9 → oe_python_template_example-0.1.0}/.gitignore

@@ -8,6 +8,15 @@ ENV/
 env/
 .envrc
 
+## secrets
+.secret
+.secrets
+.secrets.toml
+.secrets.yaml
+.secrets.yml
+.secrets.json
+.act-env-secret
+
 # Python virtual environment
 venv/
 .venv/

{oe_python_template_example-0.0.9 → oe_python_template_example-0.1.0}/.pre-commit-config.yaml

@@ -14,6 +14,7 @@ repos:
     hooks:
       - id: python-check-blanket-noqa
       - id: python-check-blanket-type-ignore
+        exclude: "^examples/notebook.py$"
       - id: python-check-mock-methods
       - id: python-no-eval
       - id: python-no-log-warn

{oe_python_template_example-0.0.9 → oe_python_template_example-0.1.0}/Dockerfile

@@ -35,5 +35,8 @@ RUN --mount=type=cache,target=/root/.cache/uv \
 
 ENV OE_PYTHON_TEMPLATE_EXAMPLE_RUNNING_IN_CONTAINER=1
 
+# API will run on port 8000 by default
+EXPOSE 8000/tcp
+
 # But feel free to add arguments and options as needed when doing a docker run
 ENTRYPOINT ["uv", "run", "--no-dev", "oe-python-template-example"]

{oe_python_template_example-0.0.9 → oe_python_template_example-0.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oe-python-template-example
-Version: 0.0.9
+Version: 0.1.0
 Summary: 🧠 Example project scaffolded and kept up to date with OE Python Template (oe-python-template).
 Project-URL: Homepage, https://oe-python-template-example.readthedocs.io/en/latest/
 Project-URL: Documentation, https://oe-python-template-example.readthedocs.io/en/latest/
@@ -101,9 +101,9 @@ Use Cases:
 2) Consistent update of already scaffolded projects to benefit from new and improved features.
 3) Dummy CLI application and service demonstrating example usage of the generated directory structure and build pipeline
 
-## Scaffolding Instructions
+## Scaffolding
 
-Step 1: Install uv package manager and copier
+**Step 1**: Install uv package manager and copier
 ```shell
 if [[ "$OSTYPE" == "darwin"* ]]; then                 # Install dependencies for macOS X
   if ! command -v brew &> /dev/null; then             ## Install Homebrew if not present
@@ -119,31 +119,32 @@ fi
 uv tool install copier                                # Install copier as global tool
 ```
 
-Step 2: Now create an empty repo on GitHub and clone it to your local machine in a directory of your choice. Change to that directory.
+**Step 2**: Now create an empty repository on GitHubm, clone to your local machine, and change into it's directory.
 
-Step 3: Scaffold the project
+**Step 3**: Scaffold the project
 ```shell
 copier copy gh:helmut-hoffer-von-ankershoffen/oe-python-template .
 ```
-Step 4: Setup the local environment
+**Step 4**: Setup the local environment
 
 ```shell
 uv run nox -s setup_dev
 ```
 
-Step 5: Perform inital commit and push
+**Step 5**: Perform initial commit and push
 ```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.
 
-Step 6: Follow the instructions in SERVICE_CONNECTIONS.md to setup the connections to external services
-such as Cloudcov, SonarQube Cloud, Read The Docs, Docker.io, GHCR.io and Streamlit Community Cloud.
+**Step 6**: Follow the [SERVICE_INSTRUCTIONS.md](instructions) to wire up
+external services such as Cloudcov, SonarQube Cloud, Read The Docs, Docker.io, GHCR.io and Streamlit Community Cloud.
 
-Step 7: Release the first versions
+**Step 7**: Release the first versions
 ```shell
 ./bump
 ```
@@ -166,25 +167,39 @@ If you don't have uv installed follow [these instructions](https://docs.astral.s
 pip install oe-python-template-example        # add dependency to your project
 ```
 
-Executing the command line interface (CLI) is just as easy:
+Executing the command line interface (CLI) in an isolated Python environment is just as easy:
 
 ```shell
-uvx oe-python-template-example
+uvx oe-python-template-example hello-world     # prints "Hello, world! [..]"
+uvx oe-python-template-example serve           # serves webservice API
 ```
 
+When serving the 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 result.
+
+The API is versioned and provides interactive documentation at [http://127.0.0.1:8000/api/v1/docs](http://127.0.0.1:8000/api/v1/docs) resp. [http://127.0.0.1:8000/api/v2/docs](http://127.0.0.1:8000/api/v2/docs)
+
+
+```shell
+
+When running the webservice API, goto http://127.0.0.1:8000/api/v1/docs
+
 The CLI provides extensive help:
 
 ```shell
 uvx oe-python-template-example --help                # all CLI commands
 uvx oe-python-template-example hello-world --help    # help for specific command
+uvx oe-python-template-example echo --help
+uvx oe-python-template-example openapi --help
+uvx oe-python-template-example serve --help
 ```
 
 
-## Highlights
+## Operational Excellence
 
-* Example project scaffolded and kept up to date with OE Python Template (oe-python-template).
-* Various Examples:
-  - [Simple Python script]https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/script.py)
+This project is designed with operational excellence in mind, using modern Python tooling and practices. It includes:
+
+* Various examples demonstrating usage:
+  - [Simple Python script](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/script.py)
   - [Streamlit web application](https://oe-python-template-example.streamlit.app/) deployed on [Streamlit Community Cloud](https://streamlit.io/cloud)
   - [Jupyter](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/notebook.ipynb) and [Marimo](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/notebook.py) notebook
 * [Complete reference documenation](https://oe-python-template-example.readthedocs.io/en/latest/reference.html) on Read the Docs
@@ -199,6 +214,9 @@ uvx oe-python-template-example hello-world --help    # help for specific command
 
 ## Usage Examples
 
+The following examples run from source. Clone this repository first using
+`git clone git@github.com:helmut-hoffer-von-ankershoffen/oe-python-template-example.git`.
+
 ### Minimal Python Script:
 
 ```python
@@ -240,7 +258,7 @@ uv run streamlit run examples/streamlit.py          # Serve on localhost:8501, o
 ... or run within VSCode
 
 ```shell
-uv sync --all-extras                                # Install ipykernel dependency part of the examples extra, see pyproject.toml
+uv sync --all-extras                                # Install dependencies required for examples such as Juypyter kernel, see pyproject.toml
 ```
 Install the [Jupyter extension for VSCode](https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter)
 
@@ -284,8 +302,12 @@ Execute commands:
 
 ```shell
 uvx oe-python-template-example hello-world
-uvx oe-python-template-example hello-world --json
-uvx oe-python-template-example echo "Lorem Ipsum"
+uvx oe-python-template-example echo --help
+uvx oe-python-template-example echo "Lorem"
+uvx oe-python-template-example echo "Lorem" --json
+uvx oe-python-template-example openapi
+uvx oe-python-template-example openapi --output-format=json
+uvx oe-python-template-example serve
 ```
 
 ### Environment
@@ -306,8 +328,12 @@ You can as well run the CLI within Docker.
 ```shell
 docker run helmuthva/oe-python-template-example --help
 docker run helmuthva/oe-python-template-example hello-world
-docker run helmuthva/oe-python-template-example hello-world --json
+docker run helmuthva/oe-python-template-example echo --help
 docker run helmuthva/oe-python-template-example echo "Lorem"
+docker run helmuthva/oe-python-template-example echo "Lorem" --json
+docker run helmuthva/oe-python-template-example openapi
+docker run helmuthva/oe-python-template-example openapi --output-format=json
+docker run helmuthva/oe-python-template-example serve
 ```
 
 Execute command:
@@ -321,8 +347,18 @@ Or use docker compose
 The .env is passed through from the host to the Docker container.
 
 ```shell
-docker compose up
 docker compose run oe-python-template-example --help
+docker compose run oe-python-template-example hello-world
+docker compose run oe-python-template-example echo --help
+docker compose run oe-python-template-example echo "Lorem"
+docker compose run oe-python-template-example echo "Lorem" --json
+docker compose run oe-python-template-example openapi
+docker compose run oe-python-template-example openapi --output-format=json
+docker compose up
+curl http://127.0.0.1:8000/api/v1/hello-world
+curl http://127.0.0.1:8000/api/v1/docs
+curl http://127.0.0.1:8000/api/v2/hello-world
+curl http://127.0.0.1:8000/api/v2/docs
 ```
 
 ## Extra: Lorem Ipsum

{oe_python_template_example-0.0.9 → oe_python_template_example-0.1.0}/README.md

@@ -40,9 +40,9 @@ Use Cases:
 2) Consistent update of already scaffolded projects to benefit from new and improved features.
 3) Dummy CLI application and service demonstrating example usage of the generated directory structure and build pipeline
 
-## Scaffolding Instructions
+## Scaffolding
 
-Step 1: Install uv package manager and copier
+**Step 1**: Install uv package manager and copier
 ```shell
 if [[ "$OSTYPE" == "darwin"* ]]; then                 # Install dependencies for macOS X
   if ! command -v brew &> /dev/null; then             ## Install Homebrew if not present
@@ -58,31 +58,32 @@ fi
 uv tool install copier                                # Install copier as global tool
 ```
 
-Step 2: Now create an empty repo on GitHub and clone it to your local machine in a directory of your choice. Change to that directory.
+**Step 2**: Now create an empty repository on GitHubm, clone to your local machine, and change into it's directory.
 
-Step 3: Scaffold the project
+**Step 3**: Scaffold the project
 ```shell
 copier copy gh:helmut-hoffer-von-ankershoffen/oe-python-template .
 ```
-Step 4: Setup the local environment
+**Step 4**: Setup the local environment
 
 ```shell
 uv run nox -s setup_dev
 ```
 
-Step 5: Perform inital commit and push
+**Step 5**: Perform initial commit and push
 ```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.
 
-Step 6: Follow the instructions in SERVICE_CONNECTIONS.md to setup the connections to external services
-such as Cloudcov, SonarQube Cloud, Read The Docs, Docker.io, GHCR.io and Streamlit Community Cloud.
+**Step 6**: Follow the [SERVICE_INSTRUCTIONS.md](instructions) to wire up
+external services such as Cloudcov, SonarQube Cloud, Read The Docs, Docker.io, GHCR.io and Streamlit Community Cloud.
 
-Step 7: Release the first versions
+**Step 7**: Release the first versions
 ```shell
 ./bump
 ```
@@ -105,25 +106,39 @@ If you don't have uv installed follow [these instructions](https://docs.astral.s
 pip install oe-python-template-example        # add dependency to your project
 ```
 
-Executing the command line interface (CLI) is just as easy:
+Executing the command line interface (CLI) in an isolated Python environment is just as easy:
 
 ```shell
-uvx oe-python-template-example
+uvx oe-python-template-example hello-world     # prints "Hello, world! [..]"
+uvx oe-python-template-example serve           # serves webservice API
 ```
 
+When serving the 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 result.
+
+The API is versioned and provides interactive documentation at [http://127.0.0.1:8000/api/v1/docs](http://127.0.0.1:8000/api/v1/docs) resp. [http://127.0.0.1:8000/api/v2/docs](http://127.0.0.1:8000/api/v2/docs)
+
+
+```shell
+
+When running the webservice API, goto http://127.0.0.1:8000/api/v1/docs
+
 The CLI provides extensive help:
 
 ```shell
 uvx oe-python-template-example --help                # all CLI commands
 uvx oe-python-template-example hello-world --help    # help for specific command
+uvx oe-python-template-example echo --help
+uvx oe-python-template-example openapi --help
+uvx oe-python-template-example serve --help
 ```
 
 
-## Highlights
+## Operational Excellence
 
-* Example project scaffolded and kept up to date with OE Python Template (oe-python-template).
-* Various Examples:
-  - [Simple Python script]https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/script.py)
+This project is designed with operational excellence in mind, using modern Python tooling and practices. It includes:
+
+* Various examples demonstrating usage:
+  - [Simple Python script](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/script.py)
   - [Streamlit web application](https://oe-python-template-example.streamlit.app/) deployed on [Streamlit Community Cloud](https://streamlit.io/cloud)
   - [Jupyter](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/notebook.ipynb) and [Marimo](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/notebook.py) notebook
 * [Complete reference documenation](https://oe-python-template-example.readthedocs.io/en/latest/reference.html) on Read the Docs
@@ -138,6 +153,9 @@ uvx oe-python-template-example hello-world --help    # help for specific command
 
 ## Usage Examples
 
+The following examples run from source. Clone this repository first using
+`git clone git@github.com:helmut-hoffer-von-ankershoffen/oe-python-template-example.git`.
+
 ### Minimal Python Script:
 
 ```python
@@ -179,7 +197,7 @@ uv run streamlit run examples/streamlit.py          # Serve on localhost:8501, o
 ... or run within VSCode
 
 ```shell
-uv sync --all-extras                                # Install ipykernel dependency part of the examples extra, see pyproject.toml
+uv sync --all-extras                                # Install dependencies required for examples such as Juypyter kernel, see pyproject.toml
 ```
 Install the [Jupyter extension for VSCode](https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter)
 
@@ -223,8 +241,12 @@ Execute commands:
 
 ```shell
 uvx oe-python-template-example hello-world
-uvx oe-python-template-example hello-world --json
-uvx oe-python-template-example echo "Lorem Ipsum"
+uvx oe-python-template-example echo --help
+uvx oe-python-template-example echo "Lorem"
+uvx oe-python-template-example echo "Lorem" --json
+uvx oe-python-template-example openapi
+uvx oe-python-template-example openapi --output-format=json
+uvx oe-python-template-example serve
 ```
 
 ### Environment
@@ -245,8 +267,12 @@ You can as well run the CLI within Docker.
 ```shell
 docker run helmuthva/oe-python-template-example --help
 docker run helmuthva/oe-python-template-example hello-world
-docker run helmuthva/oe-python-template-example hello-world --json
+docker run helmuthva/oe-python-template-example echo --help
 docker run helmuthva/oe-python-template-example echo "Lorem"
+docker run helmuthva/oe-python-template-example echo "Lorem" --json
+docker run helmuthva/oe-python-template-example openapi
+docker run helmuthva/oe-python-template-example openapi --output-format=json
+docker run helmuthva/oe-python-template-example serve
 ```
 
 Execute command:
@@ -260,8 +286,18 @@ Or use docker compose
 The .env is passed through from the host to the Docker container.
 
 ```shell
-docker compose up
 docker compose run oe-python-template-example --help
+docker compose run oe-python-template-example hello-world
+docker compose run oe-python-template-example echo --help
+docker compose run oe-python-template-example echo "Lorem"
+docker compose run oe-python-template-example echo "Lorem" --json
+docker compose run oe-python-template-example openapi
+docker compose run oe-python-template-example openapi --output-format=json
+docker compose up
+curl http://127.0.0.1:8000/api/v1/hello-world
+curl http://127.0.0.1:8000/api/v1/docs
+curl http://127.0.0.1:8000/api/v2/hello-world
+curl http://127.0.0.1:8000/api/v2/docs
 ```
 
 ## Extra: Lorem Ipsum

oe_python_template_example-0.1.0/VERSION

@@ -0,0 +1 @@
+0.1.0

{oe_python_template_example-0.0.9 → oe_python_template_example-0.1.0}/_readme_main.md

@@ -5,9 +5,9 @@ Use Cases:
 2) Consistent update of already scaffolded projects to benefit from new and improved features.
 3) Dummy CLI application and service demonstrating example usage of the generated directory structure and build pipeline
 
-## Scaffolding Instructions
+## Scaffolding
 
-Step 1: Install uv package manager and copier
+**Step 1**: Install uv package manager and copier
 ```shell
 if [[ "$OSTYPE" == "darwin"* ]]; then                 # Install dependencies for macOS X
   if ! command -v brew &> /dev/null; then             ## Install Homebrew if not present
@@ -23,31 +23,32 @@ fi
 uv tool install copier                                # Install copier as global tool
 ```
 
-Step 2: Now create an empty repo on GitHub and clone it to your local machine in a directory of your choice. Change to that directory.
+**Step 2**: Now create an empty repository on GitHubm, clone to your local machine, and change into it's directory.
 
-Step 3: Scaffold the project
+**Step 3**: Scaffold the project
 ```shell
 copier copy gh:helmut-hoffer-von-ankershoffen/oe-python-template .
 ```
-Step 4: Setup the local environment
+**Step 4**: Setup the local environment
 
 ```shell
 uv run nox -s setup_dev
 ```
 
-Step 5: Perform inital commit and push
+**Step 5**: Perform initial commit and push
 ```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.
 
-Step 6: Follow the instructions in SERVICE_CONNECTIONS.md to setup the connections to external services
-such as Cloudcov, SonarQube Cloud, Read The Docs, Docker.io, GHCR.io and Streamlit Community Cloud.
+**Step 6**: Follow the [SERVICE_INSTRUCTIONS.md](instructions) to wire up
+external services such as Cloudcov, SonarQube Cloud, Read The Docs, Docker.io, GHCR.io and Streamlit Community Cloud.
 
-Step 7: Release the first versions
+**Step 7**: Release the first versions
 ```shell
 ./bump
 ```
@@ -70,25 +71,39 @@ If you don't have uv installed follow [these instructions](https://docs.astral.s
 pip install oe-python-template-example        # add dependency to your project
 ```
 
-Executing the command line interface (CLI) is just as easy:
+Executing the command line interface (CLI) in an isolated Python environment is just as easy:
 
 ```shell
-uvx oe-python-template-example
+uvx oe-python-template-example hello-world     # prints "Hello, world! [..]"
+uvx oe-python-template-example serve           # serves webservice API
 ```
 
+When serving the 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 result.
+
+The API is versioned and provides interactive documentation at [http://127.0.0.1:8000/api/v1/docs](http://127.0.0.1:8000/api/v1/docs) resp. [http://127.0.0.1:8000/api/v2/docs](http://127.0.0.1:8000/api/v2/docs)
+
+
+```shell
+
+When running the webservice API, goto http://127.0.0.1:8000/api/v1/docs
+
 The CLI provides extensive help:
 
 ```shell
 uvx oe-python-template-example --help                # all CLI commands
 uvx oe-python-template-example hello-world --help    # help for specific command
+uvx oe-python-template-example echo --help
+uvx oe-python-template-example openapi --help
+uvx oe-python-template-example serve --help
 ```
 
 
-## Highlights
+## Operational Excellence
 
-* Example project scaffolded and kept up to date with OE Python Template (oe-python-template).
-* Various Examples:
-  - [Simple Python script]https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/script.py)
+This project is designed with operational excellence in mind, using modern Python tooling and practices. It includes:
+
+* Various examples demonstrating usage:
+  - [Simple Python script](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/script.py)
   - [Streamlit web application](https://oe-python-template-example.streamlit.app/) deployed on [Streamlit Community Cloud](https://streamlit.io/cloud)
   - [Jupyter](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/notebook.ipynb) and [Marimo](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/notebook.py) notebook
 * [Complete reference documenation](https://oe-python-template-example.readthedocs.io/en/latest/reference.html) on Read the Docs
@@ -103,6 +118,9 @@ uvx oe-python-template-example hello-world --help    # help for specific command
 
 ## Usage Examples
 
+The following examples run from source. Clone this repository first using
+`git clone git@github.com:helmut-hoffer-von-ankershoffen/oe-python-template-example.git`.
+
 ### Minimal Python Script:
 
 ```python
@@ -144,7 +162,7 @@ uv run streamlit run examples/streamlit.py          # Serve on localhost:8501, o
 ... or run within VSCode
 
 ```shell
-uv sync --all-extras                                # Install ipykernel dependency part of the examples extra, see pyproject.toml
+uv sync --all-extras                                # Install dependencies required for examples such as Juypyter kernel, see pyproject.toml
 ```
 Install the [Jupyter extension for VSCode](https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter)
 
@@ -188,8 +206,12 @@ Execute commands:
 
 ```shell
 uvx oe-python-template-example hello-world
-uvx oe-python-template-example hello-world --json
-uvx oe-python-template-example echo "Lorem Ipsum"
+uvx oe-python-template-example echo --help
+uvx oe-python-template-example echo "Lorem"
+uvx oe-python-template-example echo "Lorem" --json
+uvx oe-python-template-example openapi
+uvx oe-python-template-example openapi --output-format=json
+uvx oe-python-template-example serve
 ```
 
 ### Environment
@@ -210,8 +232,12 @@ You can as well run the CLI within Docker.
 ```shell
 docker run helmuthva/oe-python-template-example --help
 docker run helmuthva/oe-python-template-example hello-world
-docker run helmuthva/oe-python-template-example hello-world --json
+docker run helmuthva/oe-python-template-example echo --help
 docker run helmuthva/oe-python-template-example echo "Lorem"
+docker run helmuthva/oe-python-template-example echo "Lorem" --json
+docker run helmuthva/oe-python-template-example openapi
+docker run helmuthva/oe-python-template-example openapi --output-format=json
+docker run helmuthva/oe-python-template-example serve
 ```
 
 Execute command:
@@ -225,8 +251,18 @@ Or use docker compose
 The .env is passed through from the host to the Docker container.
 
 ```shell
-docker compose up
 docker compose run oe-python-template-example --help
+docker compose run oe-python-template-example hello-world
+docker compose run oe-python-template-example echo --help
+docker compose run oe-python-template-example echo "Lorem"
+docker compose run oe-python-template-example echo "Lorem" --json
+docker compose run oe-python-template-example openapi
+docker compose run oe-python-template-example openapi --output-format=json
+docker compose up
+curl http://127.0.0.1:8000/api/v1/hello-world
+curl http://127.0.0.1:8000/api/v1/docs
+curl http://127.0.0.1:8000/api/v2/hello-world
+curl http://127.0.0.1:8000/api/v2/docs
 ```
 
 ## Extra: Lorem Ipsum

oe_python_template_example-0.1.0/compose.yaml

@@ -0,0 +1,35 @@
+services:
+  oe-python-template-example:
+    build: .
+    env_file:
+      - path: .env
+        required: true
+    develop:
+      watch:
+        - path: src
+          action: rebuild
+    restart: no
+    profiles:
+      - manual
+    tty: true
+    stdin_open: true
+  oe-python-template-example-api:
+    build: .
+    env_file:
+      - path: .env
+        required: true
+    develop:
+      watch:
+        - path: src
+          action: rebuild
+    command: serve --host=0.0.0.0 --port=8000 --no-reload
+    restart: always
+    ports:
+      - "8000:8000"
+    healthcheck:
+      test: [ "CMD", "curl", "-f", "http://127.0.0.1:8000/healthz" ]
+      interval: 5s
+      timeout: 2s
+      retries: 3
+      start_period: 5s
+      start_interval: 1s