oe-python-template-example 0.1.11__tar.gz → 0.1.13__tar.gz

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.
Files changed (93) hide show
  1. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.copier-answers.yml +1 -1
  2. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.github/workflows/package-build-publish-release.yml +4 -1
  3. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/CHANGELOG.md +7 -0
  4. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/PKG-INFO +68 -82
  5. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/README.md +67 -81
  6. oe_python_template_example-0.1.13/RELEASE_NOTES.md +8 -0
  7. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/SECURITY.md +9 -9
  8. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/SERVICE_CONNECTIONS.md +8 -0
  9. oe_python_template_example-0.1.13/VERSION +1 -0
  10. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/_readme_header.md +2 -0
  11. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/_readme_main.md +65 -81
  12. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/docs/source/_static/openapi_v1.yaml +16 -32
  13. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/docs/source/_static/openapi_v2.yaml +16 -32
  14. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/docs/source/conf.py +1 -1
  15. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/pyproject.toml +2 -2
  16. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/sonar-project.properties +1 -1
  17. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/uv.lock +1 -1
  18. oe_python_template_example-0.1.11/RELEASE_NOTES.md +0 -1
  19. oe_python_template_example-0.1.11/VERSION +0 -1
  20. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.act-env-public +0 -0
  21. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.devcontainer/Dockerfile +0 -0
  22. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.devcontainer/devcontainer.json +0 -0
  23. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.devcontainer/onCreateCommand +0 -0
  24. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.devcontainer/postAttachCommand +0 -0
  25. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.devcontainer/postCreateCommand +0 -0
  26. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.env.example +0 -0
  27. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.github/dependabot.yml +0 -0
  28. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.github/workflows/codeql.yml +0 -0
  29. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.github/workflows/docker-image-build-publish.yml +0 -0
  30. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.github/workflows/test-and-report.yml +0 -0
  31. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.gitignore +0 -0
  32. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.pre-commit-config.yaml +0 -0
  33. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.python-version +0 -0
  34. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.readthedocs.yml +0 -0
  35. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.secrets.baseline +0 -0
  36. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.vscode/extensions.json +0 -0
  37. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/.vscode/settings.json +0 -0
  38. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/CODEOWNERS +0 -0
  39. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/CONTRIBUTING.md +0 -0
  40. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/Dockerfile +0 -0
  41. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/LICENSE +0 -0
  42. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/_readme_footer.md +0 -0
  43. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/bin/git-cliff +0 -0
  44. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/bump +0 -0
  45. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/codecov.yml +0 -0
  46. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/compose.yaml +0 -0
  47. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/docs/Makefile +0 -0
  48. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/docs/make.bat +0 -0
  49. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/docs/source/_static/.keep +0 -0
  50. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/docs/source/_static/openapi.json +0 -0
  51. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/docs/source/_static/openapi.yaml +0 -0
  52. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/docs/source/_static/openapi_v1.json +0 -0
  53. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/docs/source/_static/openapi_v2.json +0 -0
  54. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/docs/source/api_v1.rst +0 -0
  55. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/docs/source/api_v2.rst +0 -0
  56. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/docs/source/contributing.rst +0 -0
  57. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/docs/source/index.rst +0 -0
  58. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/docs/source/latexmkrc +0 -0
  59. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/docs/source/main.rst +0 -0
  60. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/docs/source/reference.rst +0 -0
  61. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/docs/source/release-notes.rst +0 -0
  62. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/examples/__init__.py +0 -0
  63. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/examples/notebook.ipynb +0 -0
  64. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/examples/notebook.py +0 -0
  65. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/examples/script.py +0 -0
  66. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/examples/streamlit.py +0 -0
  67. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/git-cliff-2.7.0/CHANGELOG.md +0 -0
  68. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/git-cliff-2.7.0/LICENSE-APACHE +0 -0
  69. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/git-cliff-2.7.0/LICENSE-MIT +0 -0
  70. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/git-cliff-2.7.0/README.md +0 -0
  71. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/git-cliff-2.7.0/completions/_git-cliff +0 -0
  72. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/git-cliff-2.7.0/completions/_git-cliff.ps1 +0 -0
  73. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/git-cliff-2.7.0/completions/git-cliff.bash +0 -0
  74. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/git-cliff-2.7.0/completions/git-cliff.elv +0 -0
  75. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/git-cliff-2.7.0/completions/git-cliff.fish +0 -0
  76. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/git-cliff-2.7.0/git-cliff-completions +0 -0
  77. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/git-cliff-2.7.0/git-cliff-mangen +0 -0
  78. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/git-cliff-2.7.0/man/git-cliff.1 +0 -0
  79. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/git-cliff-2.7.0-x86_64-unknown-linux-gnu.tar.gz +0 -0
  80. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/github-action-run +0 -0
  81. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/latexmkrc +0 -0
  82. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/logo.png +0 -0
  83. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/noxfile.py +0 -0
  84. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/renovate.json +0 -0
  85. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/src/oe_python_template_example/__init__.py +0 -0
  86. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/src/oe_python_template_example/api.py +0 -0
  87. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/src/oe_python_template_example/cli.py +0 -0
  88. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/src/oe_python_template_example/constants.py +0 -0
  89. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/src/oe_python_template_example/service.py +0 -0
  90. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/tests/__init__.py +0 -0
  91. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/tests/api_test.py +0 -0
  92. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/tests/cli_test.py +0 -0
  93. {oe_python_template_example-0.1.11 → oe_python_template_example-0.1.13}/tests/fixtures/.keep +0 -0
@@ -1,4 +1,4 @@
1
- _commit: v0.5.5
1
+ _commit: v0.5.7
2
2
  _src_path: gh:helmut-hoffer-von-ankershoffen/oe-python-template
3
3
  author_email: helmuthva@gmail.com
4
4
  author_github_username: helmut-hoffer-von-ankershoffen
@@ -46,11 +46,14 @@ jobs:
46
46
  - name: Publish package to PyPI
47
47
  run: uv publish -t ${{ secrets.UV_PUBLISH_TOKEN }}
48
48
 
49
+ - name: Build package into dist/
50
+ run: uv run nox -s audit
51
+
49
52
  - name: Create GitHub release
50
53
  env:
51
54
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
52
55
  run: |
53
- gh release create ${{ github.ref_name }} ./dist/* --notes-file ${{ steps.git-cliff.outputs.changelog }}
56
+ gh release create ${{ github.ref_name }} ./dist/* sbom.json licenses.json licenses-inverted.json vulnerabilities.json --notes-file ${{ steps.git-cliff.outputs.changelog }}
54
57
 
55
58
  - name: Allow other workflows to trigger on release
56
59
  env:
@@ -1,5 +1,12 @@
1
1
  [🧠 OE Python Template Example](https://oe-python-template-example.readthedocs.io/en/latest/)
2
2
 
3
+ ## [0.1.13](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/compare/v0.1.12..0.1.13) - 2025-03-14
4
+
5
+ ### 📚 Documentation
6
+
7
+ - Adapt - ([6e99c1d](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/commit/6e99c1d604c8e9fe4094b6a21d95619181ea0d14))
8
+
9
+
3
10
  ## [0.1.7](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/compare/v0.1.6..v0.1.7) - 2025-03-14
4
11
 
5
12
  ### Deps
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: oe-python-template-example
3
- Version: 0.1.11
3
+ Version: 0.1.13
4
4
  Summary: 🧠 Example project scaffolded and kept up to date with OE Python Template (oe-python-template).
5
5
  Project-URL: Homepage, https://oe-python-template-example.readthedocs.io/en/latest/
6
6
  Project-URL: Documentation, https://oe-python-template-example.readthedocs.io/en/latest/
@@ -66,6 +66,8 @@ Description-Content-Type: text/markdown
66
66
  [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/oe-python-template-example.svg?logo=python&color=204361&labelColor=1E2933)](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/noxfile.py)
67
67
  [![CI](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/actions/workflows/test-and-report.yml/badge.svg)](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/actions/workflows/test-and-report.yml)
68
68
  [![Read the Docs](https://img.shields.io/readthedocs/oe-python-template-example)](https://oe-python-template-example.readthedocs.io/en/latest/)
69
+ [![CodeQL](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/actions/workflows/codeql.yml/badge.svg)](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/security/code-scanning)
70
+ [![Dependabot](https://img.shields.io/badge/dependabot-active-brightgreen?style=flat-square&logo=dependabot)](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/security/dependabot)
69
71
  [![Quality Gate](https://sonarcloud.io/api/project_badges/measure?project=helmut-hoffer-von-ankershoffen_oe-python-template-example&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_oe-python-template-example)
70
72
  [![Security](https://sonarcloud.io/api/project_badges/measure?project=helmut-hoffer-von-ankershoffen_oe-python-template-example&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_oe-python-template-example)
71
73
  [![Maintainability](https://sonarcloud.io/api/project_badges/measure?project=helmut-hoffer-von-ankershoffen_oe-python-template-example&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_oe-python-template-example)
@@ -98,64 +100,13 @@ Description-Content-Type: text/markdown
98
100
  ---
99
101
 
100
102
 
101
- Example project scaffolded and kept up to date with OE Python Template (oe-python-template).
103
+ Example project scaffolded and kept up to date with OE Python Template
104
+ (oe-python-template).
102
105
 
103
106
  Use Cases:
104
- 1) Fast and easy to use project setup
105
- 2) Consistent update of already scaffolded projects to benefit from new and improved features.
106
- 3) Dummy CLI application and service demonstrating example usage of the generated directory structure and build pipeline
107
107
 
108
- ## Scaffolding
109
-
110
- **Step 1**: Install uv package manager and copier
111
- ```shell
112
- if [[ "$OSTYPE" == "darwin"* ]]; then # Install dependencies for macOS X
113
- if ! command -v brew &> /dev/null; then ## Install Homebrew if not present
114
- /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
115
- fi
116
- elif [[ "$OSTYPE" == "linux-gnu"* ]]; then # Install dependencies for Linux
117
- sudo apt-get update -y && sudo apt-get install curl -y # Install curl
118
- fi
119
- if ! command -v uvx &> /dev/null; then # Install uv package manager if not present
120
- curl -LsSf https://astral.sh/uv/install.sh | sh
121
- source $HOME/.local/bin/env
122
- fi
123
- uv tool install copier # Install copier as global tool
124
- ```
125
-
126
- **Step 2**: Now create an empty repository on GitHubm, clone to your local machine, and change into it's directory.
127
-
128
- **Step 3**: Scaffold the project
129
- ```shell
130
- copier copy gh:helmut-hoffer-von-ankershoffen/oe-python-template .
131
- ```
132
- **Step 4**: Setup the local environment
133
-
134
- ```shell
135
- uv run nox -s setup_dev
136
- ```
137
-
138
- **Step 5**: Perform initial commit and push
139
- ```shell
140
- git add .
141
- git commit -m "feat: Initial commit"
142
- git push
143
- ```
144
-
145
- Visit your GitHub repository and check the Actions tab. The CI workflow should fail at the SonarQube step,
146
- as this external service is not yet configured for our new repository.
147
-
148
- **Step 6**: Follow the [SERVICE_INSTRUCTIONS.md](instructions) to wire up
149
- external services such as Cloudcov, SonarQube Cloud, Read The Docs, Docker.io, GHCR.io and Streamlit Community Cloud.
150
-
151
- **Step 7**: Release the first versions
152
- ```shell
153
- ./bump
154
- ```
155
- Notes:
156
- * You can remove this section post having successfully scafolded your project.
157
- * The following sections refer to the dummy application and service provided by this template.
158
- Use them as inspiration and adapt them to your own project.
108
+ 1. Dummy CLI application and service demonstrating example usage of the
109
+ directory structure and build pipeline generated by oe-python-template
159
110
 
160
111
  ## Overview
161
112
 
@@ -165,13 +116,17 @@ Adding OE Python Template Example to your project as a dependency is easy.
165
116
  uv add oe-python-template-example # add dependency to your project
166
117
  ```
167
118
 
168
- If you don't have uv installed follow [these instructions](https://docs.astral.sh/uv/getting-started/installation/). If you still prefer pip over the modern and fast package manager [uv](https://github.com/astral-sh/uv), you can install the library like this:
119
+ If you don't have uv installed follow
120
+ [these instructions](https://docs.astral.sh/uv/getting-started/installation/).
121
+ If you still prefer pip over the modern and fast package manager
122
+ [uv](https://github.com/astral-sh/uv), you can install the library like this:
169
123
 
170
124
  ```shell
171
125
  pip install oe-python-template-example # add dependency to your project
172
126
  ```
173
127
 
174
- Executing the command line interface (CLI) in an isolated Python environment is just as easy:
128
+ Executing the command line interface (CLI) in an isolated Python environment is
129
+ just as easy:
175
130
 
176
131
  ```shell
177
132
  uvx oe-python-template-example hello-world # prints "Hello, world! [..]"
@@ -180,10 +135,13 @@ uvx oe-python-template-example serve --port=4711 # serves webservice API on port
180
135
  ```
181
136
 
182
137
  Notes:
183
- * The API is versioned, mounted at ```/api/v1``` resp. ```/api/v2```
184
- * While serving the webservice 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.
185
- * Interactive documentation is provided at [http://127.0.0.1:8000/api/docs](http://127.0.0.1:8000/api/docs)
186
138
 
139
+ - The API is versioned, mounted at `/api/v1` resp. `/api/v2`
140
+ - While serving the webservice API go to
141
+ [http://127.0.0.1:8000/api/v1/hello-world](http://127.0.0.1:8000/api/v1/hello-world)
142
+ to see the respons of the `hello-world` operation.
143
+ - Interactive documentation is provided at
144
+ [http://127.0.0.1:8000/api/docs](http://127.0.0.1:8000/api/docs)
187
145
 
188
146
  The CLI provides extensive help:
189
147
 
@@ -195,24 +153,44 @@ uvx oe-python-template-example openapi --help
195
153
  uvx oe-python-template-example serve --help
196
154
  ```
197
155
 
198
-
199
156
  ## Operational Excellence
200
157
 
201
- This project is designed with operational excellence in mind, using modern Python tooling and practices. It includes:
158
+ This project is designed with operational excellence in mind, using modern
159
+ Python tooling and practices. It includes:
202
160
 
203
- * Various examples demonstrating usage:
161
+ - Various examples demonstrating usage:
204
162
  - [Simple Python script](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/script.py)
205
- - [Streamlit web application](https://oe-python-template-example.streamlit.app/) deployed on [Streamlit Community Cloud](https://streamlit.io/cloud)
206
- - [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
207
- * [Complete reference documenation](https://oe-python-template-example.readthedocs.io/en/latest/reference.html) on Read the Docs
208
- * [Transparent test coverage](https://app.codecov.io/gh/helmut-hoffer-von-ankershoffen/oe-python-template-example) including unit and E2E tests (reported on Codecov)
209
- * Matrix tested with [multiple python versions](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/noxfile.py) to ensure compatibility (powered by [Nox](https://nox.thea.codes/en/stable/))
210
- * Compliant with modern linting and formatting standards (powered by [Ruff](https://github.com/astral-sh/ruff))
211
- * Up-to-date dependencies (monitored by [Renovate](https://github.com/renovatebot/renovate))
212
- * [A-grade code quality](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_oe-python-template-example) in security, maintainability, and reliability with low technical debt and low codesmell (verified by SonarQube)
213
- * 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-example/tags)
214
- * Setup for developing inside a [devcontainer](https://code.visualstudio.com/docs/devcontainers/containers) included (supports VSCode and GitHub Codespaces)
215
-
163
+ - [Streamlit web application](https://oe-python-template-example.streamlit.app/)
164
+ deployed on [Streamlit Community Cloud](https://streamlit.io/cloud)
165
+ - [Jupyter](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/notebook.ipynb)
166
+ and
167
+ [Marimo](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/notebook.py)
168
+ notebook
169
+ - [Complete reference documentation](https://oe-python-template-example.readthedocs.io/en/latest/reference.html)
170
+ on Read the Docs
171
+ - [Transparent test coverage](https://app.codecov.io/gh/helmut-hoffer-von-ankershoffen/oe-python-template-example)
172
+ including unit and E2E tests (reported on Codecov)
173
+ - Matrix tested with
174
+ [multiple python versions](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/noxfile.py)
175
+ to ensure compatibility (powered by [Nox](https://nox.thea.codes/en/stable/))
176
+ - Compliant with modern linting and formatting standards (powered by
177
+ [Ruff](https://github.com/astral-sh/ruff))
178
+ - Up-to-date dependencies (monitored by
179
+ [Renovate](https://github.com/renovatebot/renovate) and
180
+ [GitHub Dependabot](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/security/dependabot))
181
+ - [A-grade code quality](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_oe-python-template-example)
182
+ in security, maintainability, and reliability with low technical debt and
183
+ codesmell (verified by SonarQube)
184
+ - Additional code security checks using
185
+ [GitHub CodeQL](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/security/code-scanning)
186
+ - [Security Policy](SECURITY.md)
187
+ - [License](LICENSE) compliant with the Open Source Initiative (OSI)
188
+ - 1-liner for installation and execution of command line interface (CLI) via
189
+ [uv(x)](https://github.com/astral-sh/uv) or
190
+ [Docker](https://hub.docker.com/r/helmuthva/oe-python-template-example/tags)
191
+ - Setup for developing inside a
192
+ [devcontainer](https://code.visualstudio.com/docs/devcontainers/containers)
193
+ included (supports VSCode and GitHub Codespaces)
216
194
 
217
195
  ## Usage Examples
218
196
 
@@ -237,15 +215,19 @@ message = Service.get_hello_world()
237
215
  console.print(f"[blue]{message}[/blue]")
238
216
  ```
239
217
 
240
- [Show script code](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/script.py) - [Read the reference documentation](https://oe-python-template-example.readthedocs.io/en/latest/reference.html)
218
+ [Show script code](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/script.py) -
219
+ [Read the reference documentation](https://oe-python-template-example.readthedocs.io/en/latest/reference.html)
241
220
 
242
221
  ### Streamlit App
243
222
 
244
- Serve the functionality provided by OE Python Template Example in the web by easily integrating the service into a Streamlit application.
223
+ Serve the functionality provided by OE Python Template Example in the web by
224
+ easily integrating the service into a Streamlit application.
245
225
 
246
- [Try it out!](https://oe-python-template-example.streamlit.app) - [Show the code](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/streamlit.py)
226
+ [Try it out!](https://oe-python-template-example.streamlit.app) -
227
+ [Show the code](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/streamlit.py)
247
228
 
248
229
  ... or serve the app locally
230
+
249
231
  ```shell
250
232
  uv sync --all-extras # Install streamlit dependency part of the examples extra, see pyproject.toml
251
233
  uv run streamlit run examples/streamlit.py # Serve on localhost:8501, opens browser
@@ -262,7 +244,9 @@ uv run streamlit run examples/streamlit.py # Serve on localhost:8501, o
262
244
  ```shell
263
245
  uv sync --all-extras # Install dependencies required for examples such as Juypyter kernel, see pyproject.toml
264
246
  ```
265
- Install the [Jupyter extension for VSCode](https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter)
247
+
248
+ Install the
249
+ [Jupyter extension for VSCode](https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter)
266
250
 
267
251
  Click on `examples/notebook.ipynb` in VSCode and run it.
268
252
 
@@ -286,9 +270,11 @@ uv run marimo edit examples/notebook.py --watch # Edit on localhost:2718, op
286
270
 
287
271
  ... or edit interactively within VSCode
288
272
 
289
- Install the [Marimo extension for VSCode](https://marketplace.visualstudio.com/items?itemName=marimo-team.vscode-marimo)
273
+ Install the
274
+ [Marimo extension for VSCode](https://marketplace.visualstudio.com/items?itemName=marimo-team.vscode-marimo)
290
275
 
291
- Click on `examples/notebook.py` in VSCode and click on the caret next to the Run icon above the code (looks like a pencil) > "Start in marimo editor" (edit).
276
+ Click on `examples/notebook.py` in VSCode and click on the caret next to the Run
277
+ icon above the code (looks like a pencil) > "Start in marimo editor" (edit).
292
278
 
293
279
  ## Command Line Interface (CLI)
294
280
 
@@ -365,7 +351,7 @@ curl http://127.0.0.1:8000/api/v2/docs
365
351
 
366
352
  ## Extra: Lorem Ipsum
367
353
 
368
- Dolor sit amet, consectetur adipiscing elit. Donec a diam lectus. Sed sit amet ipsum mauris. Maecenas congue ligula ac quam.
354
+ Nothing yet
369
355
 
370
356
 
371
357
  ## Further Reading
@@ -5,6 +5,8 @@
5
5
  [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/oe-python-template-example.svg?logo=python&color=204361&labelColor=1E2933)](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/noxfile.py)
6
6
  [![CI](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/actions/workflows/test-and-report.yml/badge.svg)](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/actions/workflows/test-and-report.yml)
7
7
  [![Read the Docs](https://img.shields.io/readthedocs/oe-python-template-example)](https://oe-python-template-example.readthedocs.io/en/latest/)
8
+ [![CodeQL](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/actions/workflows/codeql.yml/badge.svg)](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/security/code-scanning)
9
+ [![Dependabot](https://img.shields.io/badge/dependabot-active-brightgreen?style=flat-square&logo=dependabot)](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/security/dependabot)
8
10
  [![Quality Gate](https://sonarcloud.io/api/project_badges/measure?project=helmut-hoffer-von-ankershoffen_oe-python-template-example&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_oe-python-template-example)
9
11
  [![Security](https://sonarcloud.io/api/project_badges/measure?project=helmut-hoffer-von-ankershoffen_oe-python-template-example&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_oe-python-template-example)
10
12
  [![Maintainability](https://sonarcloud.io/api/project_badges/measure?project=helmut-hoffer-von-ankershoffen_oe-python-template-example&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_oe-python-template-example)
@@ -37,64 +39,13 @@
37
39
  ---
38
40
 
39
41
 
40
- Example project scaffolded and kept up to date with OE Python Template (oe-python-template).
42
+ Example project scaffolded and kept up to date with OE Python Template
43
+ (oe-python-template).
41
44
 
42
45
  Use Cases:
43
- 1) Fast and easy to use project setup
44
- 2) Consistent update of already scaffolded projects to benefit from new and improved features.
45
- 3) Dummy CLI application and service demonstrating example usage of the generated directory structure and build pipeline
46
46
 
47
- ## Scaffolding
48
-
49
- **Step 1**: Install uv package manager and copier
50
- ```shell
51
- if [[ "$OSTYPE" == "darwin"* ]]; then # Install dependencies for macOS X
52
- if ! command -v brew &> /dev/null; then ## Install Homebrew if not present
53
- /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
54
- fi
55
- elif [[ "$OSTYPE" == "linux-gnu"* ]]; then # Install dependencies for Linux
56
- sudo apt-get update -y && sudo apt-get install curl -y # Install curl
57
- fi
58
- if ! command -v uvx &> /dev/null; then # Install uv package manager if not present
59
- curl -LsSf https://astral.sh/uv/install.sh | sh
60
- source $HOME/.local/bin/env
61
- fi
62
- uv tool install copier # Install copier as global tool
63
- ```
64
-
65
- **Step 2**: Now create an empty repository on GitHubm, clone to your local machine, and change into it's directory.
66
-
67
- **Step 3**: Scaffold the project
68
- ```shell
69
- copier copy gh:helmut-hoffer-von-ankershoffen/oe-python-template .
70
- ```
71
- **Step 4**: Setup the local environment
72
-
73
- ```shell
74
- uv run nox -s setup_dev
75
- ```
76
-
77
- **Step 5**: Perform initial commit and push
78
- ```shell
79
- git add .
80
- git commit -m "feat: Initial commit"
81
- git push
82
- ```
83
-
84
- Visit your GitHub repository and check the Actions tab. The CI workflow should fail at the SonarQube step,
85
- as this external service is not yet configured for our new repository.
86
-
87
- **Step 6**: Follow the [SERVICE_INSTRUCTIONS.md](instructions) to wire up
88
- external services such as Cloudcov, SonarQube Cloud, Read The Docs, Docker.io, GHCR.io and Streamlit Community Cloud.
89
-
90
- **Step 7**: Release the first versions
91
- ```shell
92
- ./bump
93
- ```
94
- Notes:
95
- * You can remove this section post having successfully scafolded your project.
96
- * The following sections refer to the dummy application and service provided by this template.
97
- Use them as inspiration and adapt them to your own project.
47
+ 1. Dummy CLI application and service demonstrating example usage of the
48
+ directory structure and build pipeline generated by oe-python-template
98
49
 
99
50
  ## Overview
100
51
 
@@ -104,13 +55,17 @@ Adding OE Python Template Example to your project as a dependency is easy.
104
55
  uv add oe-python-template-example # add dependency to your project
105
56
  ```
106
57
 
107
- If you don't have uv installed follow [these instructions](https://docs.astral.sh/uv/getting-started/installation/). If you still prefer pip over the modern and fast package manager [uv](https://github.com/astral-sh/uv), you can install the library like this:
58
+ If you don't have uv installed follow
59
+ [these instructions](https://docs.astral.sh/uv/getting-started/installation/).
60
+ If you still prefer pip over the modern and fast package manager
61
+ [uv](https://github.com/astral-sh/uv), you can install the library like this:
108
62
 
109
63
  ```shell
110
64
  pip install oe-python-template-example # add dependency to your project
111
65
  ```
112
66
 
113
- Executing the command line interface (CLI) in an isolated Python environment is just as easy:
67
+ Executing the command line interface (CLI) in an isolated Python environment is
68
+ just as easy:
114
69
 
115
70
  ```shell
116
71
  uvx oe-python-template-example hello-world # prints "Hello, world! [..]"
@@ -119,10 +74,13 @@ uvx oe-python-template-example serve --port=4711 # serves webservice API on port
119
74
  ```
120
75
 
121
76
  Notes:
122
- * The API is versioned, mounted at ```/api/v1``` resp. ```/api/v2```
123
- * While serving the webservice 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.
124
- * Interactive documentation is provided at [http://127.0.0.1:8000/api/docs](http://127.0.0.1:8000/api/docs)
125
77
 
78
+ - The API is versioned, mounted at `/api/v1` resp. `/api/v2`
79
+ - While serving the webservice API go to
80
+ [http://127.0.0.1:8000/api/v1/hello-world](http://127.0.0.1:8000/api/v1/hello-world)
81
+ to see the respons of the `hello-world` operation.
82
+ - Interactive documentation is provided at
83
+ [http://127.0.0.1:8000/api/docs](http://127.0.0.1:8000/api/docs)
126
84
 
127
85
  The CLI provides extensive help:
128
86
 
@@ -134,24 +92,44 @@ uvx oe-python-template-example openapi --help
134
92
  uvx oe-python-template-example serve --help
135
93
  ```
136
94
 
137
-
138
95
  ## Operational Excellence
139
96
 
140
- This project is designed with operational excellence in mind, using modern Python tooling and practices. It includes:
97
+ This project is designed with operational excellence in mind, using modern
98
+ Python tooling and practices. It includes:
141
99
 
142
- * Various examples demonstrating usage:
100
+ - Various examples demonstrating usage:
143
101
  - [Simple Python script](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/script.py)
144
- - [Streamlit web application](https://oe-python-template-example.streamlit.app/) deployed on [Streamlit Community Cloud](https://streamlit.io/cloud)
145
- - [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
146
- * [Complete reference documenation](https://oe-python-template-example.readthedocs.io/en/latest/reference.html) on Read the Docs
147
- * [Transparent test coverage](https://app.codecov.io/gh/helmut-hoffer-von-ankershoffen/oe-python-template-example) including unit and E2E tests (reported on Codecov)
148
- * Matrix tested with [multiple python versions](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/noxfile.py) to ensure compatibility (powered by [Nox](https://nox.thea.codes/en/stable/))
149
- * Compliant with modern linting and formatting standards (powered by [Ruff](https://github.com/astral-sh/ruff))
150
- * Up-to-date dependencies (monitored by [Renovate](https://github.com/renovatebot/renovate))
151
- * [A-grade code quality](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_oe-python-template-example) in security, maintainability, and reliability with low technical debt and low codesmell (verified by SonarQube)
152
- * 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-example/tags)
153
- * Setup for developing inside a [devcontainer](https://code.visualstudio.com/docs/devcontainers/containers) included (supports VSCode and GitHub Codespaces)
154
-
102
+ - [Streamlit web application](https://oe-python-template-example.streamlit.app/)
103
+ deployed on [Streamlit Community Cloud](https://streamlit.io/cloud)
104
+ - [Jupyter](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/notebook.ipynb)
105
+ and
106
+ [Marimo](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/notebook.py)
107
+ notebook
108
+ - [Complete reference documentation](https://oe-python-template-example.readthedocs.io/en/latest/reference.html)
109
+ on Read the Docs
110
+ - [Transparent test coverage](https://app.codecov.io/gh/helmut-hoffer-von-ankershoffen/oe-python-template-example)
111
+ including unit and E2E tests (reported on Codecov)
112
+ - Matrix tested with
113
+ [multiple python versions](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/noxfile.py)
114
+ to ensure compatibility (powered by [Nox](https://nox.thea.codes/en/stable/))
115
+ - Compliant with modern linting and formatting standards (powered by
116
+ [Ruff](https://github.com/astral-sh/ruff))
117
+ - Up-to-date dependencies (monitored by
118
+ [Renovate](https://github.com/renovatebot/renovate) and
119
+ [GitHub Dependabot](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/security/dependabot))
120
+ - [A-grade code quality](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_oe-python-template-example)
121
+ in security, maintainability, and reliability with low technical debt and
122
+ codesmell (verified by SonarQube)
123
+ - Additional code security checks using
124
+ [GitHub CodeQL](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/security/code-scanning)
125
+ - [Security Policy](SECURITY.md)
126
+ - [License](LICENSE) compliant with the Open Source Initiative (OSI)
127
+ - 1-liner for installation and execution of command line interface (CLI) via
128
+ [uv(x)](https://github.com/astral-sh/uv) or
129
+ [Docker](https://hub.docker.com/r/helmuthva/oe-python-template-example/tags)
130
+ - Setup for developing inside a
131
+ [devcontainer](https://code.visualstudio.com/docs/devcontainers/containers)
132
+ included (supports VSCode and GitHub Codespaces)
155
133
 
156
134
  ## Usage Examples
157
135
 
@@ -176,15 +154,19 @@ message = Service.get_hello_world()
176
154
  console.print(f"[blue]{message}[/blue]")
177
155
  ```
178
156
 
179
- [Show script code](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/script.py) - [Read the reference documentation](https://oe-python-template-example.readthedocs.io/en/latest/reference.html)
157
+ [Show script code](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/script.py) -
158
+ [Read the reference documentation](https://oe-python-template-example.readthedocs.io/en/latest/reference.html)
180
159
 
181
160
  ### Streamlit App
182
161
 
183
- Serve the functionality provided by OE Python Template Example in the web by easily integrating the service into a Streamlit application.
162
+ Serve the functionality provided by OE Python Template Example in the web by
163
+ easily integrating the service into a Streamlit application.
184
164
 
185
- [Try it out!](https://oe-python-template-example.streamlit.app) - [Show the code](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/streamlit.py)
165
+ [Try it out!](https://oe-python-template-example.streamlit.app) -
166
+ [Show the code](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/examples/streamlit.py)
186
167
 
187
168
  ... or serve the app locally
169
+
188
170
  ```shell
189
171
  uv sync --all-extras # Install streamlit dependency part of the examples extra, see pyproject.toml
190
172
  uv run streamlit run examples/streamlit.py # Serve on localhost:8501, opens browser
@@ -201,7 +183,9 @@ uv run streamlit run examples/streamlit.py # Serve on localhost:8501, o
201
183
  ```shell
202
184
  uv sync --all-extras # Install dependencies required for examples such as Juypyter kernel, see pyproject.toml
203
185
  ```
204
- Install the [Jupyter extension for VSCode](https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter)
186
+
187
+ Install the
188
+ [Jupyter extension for VSCode](https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter)
205
189
 
206
190
  Click on `examples/notebook.ipynb` in VSCode and run it.
207
191
 
@@ -225,9 +209,11 @@ uv run marimo edit examples/notebook.py --watch # Edit on localhost:2718, op
225
209
 
226
210
  ... or edit interactively within VSCode
227
211
 
228
- Install the [Marimo extension for VSCode](https://marketplace.visualstudio.com/items?itemName=marimo-team.vscode-marimo)
212
+ Install the
213
+ [Marimo extension for VSCode](https://marketplace.visualstudio.com/items?itemName=marimo-team.vscode-marimo)
229
214
 
230
- Click on `examples/notebook.py` in VSCode and click on the caret next to the Run icon above the code (looks like a pencil) > "Start in marimo editor" (edit).
215
+ Click on `examples/notebook.py` in VSCode and click on the caret next to the Run
216
+ icon above the code (looks like a pencil) > "Start in marimo editor" (edit).
231
217
 
232
218
  ## Command Line Interface (CLI)
233
219
 
@@ -304,7 +290,7 @@ curl http://127.0.0.1:8000/api/v2/docs
304
290
 
305
291
  ## Extra: Lorem Ipsum
306
292
 
307
- Dolor sit amet, consectetur adipiscing elit. Donec a diam lectus. Sed sit amet ipsum mauris. Maecenas congue ligula ac quam.
293
+ Nothing yet
308
294
 
309
295
 
310
296
  ## Further Reading
@@ -0,0 +1,8 @@
1
+ ## [0.1.13](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/compare/v0.1.12..v0.1.13) - 2025-03-14
2
+
3
+ ### 📚 Documentation
4
+
5
+ - Adapt - ([6e99c1d](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/commit/6e99c1d604c8e9fe4094b6a21d95619181ea0d14))
6
+
7
+
8
+
@@ -20,23 +20,23 @@ OE Python Template Example employs several automated tools to continuously monit
20
20
 
21
21
  ### 1. Dependency Vulnerability Scanning
22
22
 
23
- - **Renovate Bot**: Automatically creates pull requests to update dependencies when new versions are available, with a focus on security patches.
24
- - **GitHub Dependabot**: Monitors dependencies for known vulnerabilities and automatically creates pull requests to update them when security issues are found.
25
- - **pip-audit**: Regularly scans Python dependencies for known vulnerabilities using data from the Python Advisory Database.
23
+ - **GitHub Dependabot**: Monitors dependencies for known vulnerabilities and automatically creates pull requests to update them when security issues are found. [Dependendabot alerts](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/security/dependabot) published.
24
+ - **Renovate Bot**: Automatically creates pull requests to update dependencies when new versions are available, with a focus on security patches. [Dependency Dashboard](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/issues) published.
25
+ - **pip-audit**: Regularly scans Python dependencies for known vulnerabilities using data from the Python Advisory Database. ```vulnerabilities.json``` published [per release](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/releases).
26
26
 
27
27
  ### 2. Dependency Compliance
28
28
 
29
- - **pip-licenses**: Exports the licenses of all dependencies to ensure compliance with licensing requirements and avoid using components with problematic licenses.
30
- - **cyclonedx-py**: Generates a Software Bill of Materials (SBOM) in SPDX format, listing all components and dependencies used in the project.
29
+ - **cyclonedx-py**: Generates a Software Bill of Materials (SBOM) in SPDX format, listing all components and dependencies used in the project. ```sbom.json``` (SPDX format) published [per release](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/releases).
30
+ - **pip-licenses**: Exports the licenses of all dependencies to ensure compliance with licensing requirements and avoid using components with problematic licenses. ```licenses.json``` and ```licenses-inverted.json``` published [per release](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/releases).
31
31
 
32
32
  ### 3. Static Code Analysis
33
33
 
34
- - **SonarQube**: Performs comprehensive static code analysis to detect code quality issues, security vulnerabilities, and bugs.
35
- - **GitHub CodeQL**: Analyzes code for common vulnerabilities and coding errors using GitHub's semantic code analysis engine.
34
+ - **GitHub CodeQL**: Analyzes code for common vulnerabilities and coding errors using GitHub's semantic code analysis engine. [Code scanning results](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/security/code-scanning) published.
35
+ - **SonarQube**: Performs comprehensive static code analysis to detect code quality issues, security vulnerabilities, and bugs. [Security hotspots](https://sonarcloud.io/project/security_hotspots?id=helmut-hoffer-von-ankershoffen_oe-python-template-example) published.
36
36
 
37
37
  ### 4. Secret Detection
38
-
39
- - **Yelp/detect-secrets**: Pre-commit hook and automated scanning to prevent accidental inclusion of secrets or sensitive information in the codebase.
38
+ - **GitHub Secret scanning**: Automatically scans for secrets in the codebase and alerts if any are found. [Secret scanning alerts](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/security/secret-scanning) published.
39
+ - **Yelp/detect-secrets**: Pre-commit hook and automated scanning to prevent accidental inclusion of secrets or sensitive information in commits. [Pre-Commit hook](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/.pre-commit-config.yaml) published.
40
40
 
41
41
  ## Security Best Practices
42
42
 
@@ -61,6 +61,14 @@
61
61
  4. Select the oe-python-template-example repo, for "Main file path" select `examples/streamlit.py`, for App URL enter `oe-python-template-example`.streamlit.app. Click "Deploy"
62
62
  5. Goto https://oe-python-template-example.streamlit.app
63
63
 
64
+ ## GitHub repository settings
65
+
66
+ 1. Goto https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/settings/security_analysis
67
+ 2. Enable Private vulnerability reporting
68
+ 3. Enable Dependabot alerts
69
+ 4. Enable Dependabot security updates
70
+ 5. CodeQL analyis will be automatically set up via a GitHub action
71
+
64
72
  ## Polishing GitHub repository
65
73
 
66
74
  1. Goto https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example
@@ -0,0 +1 @@
1
+ 0.1.13
@@ -5,6 +5,8 @@
5
5
  [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/oe-python-template-example.svg?logo=python&color=204361&labelColor=1E2933)](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/blob/main/noxfile.py)
6
6
  [![CI](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/actions/workflows/test-and-report.yml/badge.svg)](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/actions/workflows/test-and-report.yml)
7
7
  [![Read the Docs](https://img.shields.io/readthedocs/oe-python-template-example)](https://oe-python-template-example.readthedocs.io/en/latest/)
8
+ [![CodeQL](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/actions/workflows/codeql.yml/badge.svg)](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/security/code-scanning)
9
+ [![Dependabot](https://img.shields.io/badge/dependabot-active-brightgreen?style=flat-square&logo=dependabot)](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example/security/dependabot)
8
10
  [![Quality Gate](https://sonarcloud.io/api/project_badges/measure?project=helmut-hoffer-von-ankershoffen_oe-python-template-example&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_oe-python-template-example)
9
11
  [![Security](https://sonarcloud.io/api/project_badges/measure?project=helmut-hoffer-von-ankershoffen_oe-python-template-example&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_oe-python-template-example)
10
12
  [![Maintainability](https://sonarcloud.io/api/project_badges/measure?project=helmut-hoffer-von-ankershoffen_oe-python-template-example&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=helmut-hoffer-von-ankershoffen_oe-python-template-example)