ci: Update python example

.dockerignore

@@ -0,0 +1,10 @@
+# all start with .(dot), including directories and files
+.*
+CHANGELOG.md
+CODE_OF_CONDUCT.md
+compose.yml
+CONTRIBUTING.md
+Dockerfile
+LICENSE*
+README.md
+SECURITY.md

.editorconfig

@@ -0,0 +1,14 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+max_line_length = 120
+tab_width = 4
+trim_trailing_whitespace = true
+
+[Makefile]
+indent_style = tab

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,44 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: 'bug: '
+labels: bug
+assignees: ''
+
+---
+
+## Bug description
+
+<!-- A clear and concise description of what the bug is. -->
+
+- Would you like to work on a fix? [y/n]
+
+## To Reproduce
+
+Steps to reproduce the behavior:
+
+1. ...
+2. ...
+3. ...
+4. ...
+
+<!-- Make sure you are able to reproduce the bug in the main branch, too. -->
+
+## Expected behavior
+
+<!-- A clear and concise description of what you expected to happen. -->
+
+## Screenshots
+
+<!-- If applicable, add screenshots to help explain your problem. -->
+
+## Environment
+
+<!-- Please fill the following information. -->
+
+- OS: [e.g. Ubuntu 20.04]
+- example_py version: [e.g. 0.1.0]
+
+## Additional context
+
+<!-- Add any other context about the problem here. -->

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: true

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,28 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: 'Feature Request: '
+labels: enhancement
+assignees: ''
+
+---
+
+## Motivations
+
+<!--
+If your feature request is related to a problem, please describe it.
+-->
+
+- Would you like to implement this feature? [y/n]
+
+## Solution
+
+<!-- Describe the solution you'd like. -->
+
+## Alternatives
+
+<!-- Describe any alternative solutions or features you've considered. -->
+
+## Additional context
+
+<!-- Add any other context or screenshots about the feature request here. -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,9 @@
+<!-- Please explain the changes you made -->
+
+<!--
+Please make sure:
+- you have read the contributing guidelines:
+  https://github.com/x-pt/example-py/blob/main/docs/CONTRIBUTING.md
+- you have updated the changelog (if needed):
+  https://github.com/x-pt/example-py/blob/main/CHANGELOG.md
+-->

.github/configs/labeler.yml

@@ -0,0 +1,63 @@
+version: 1
+
+labels:
+    # Type: Build-related changes
+    -   label: "@type/build"
+        title: '^build(?:\(.+\))?\!?:'
+
+    # Type: CI-related changes
+    -   label: "@type/ci"
+        title: '^ci(?:\(.+\))?\!?:'
+        files:
+            - '\.github/.+'
+
+    # Type: Documentation changes
+    -   label: "@type/docs"
+        title: '^docs(?:\(.+\))?\!?:'
+        files:
+            - "docs/.+"
+            - "**/*.md"
+
+    # Type: New feature
+    -   label: "@type/feature"
+        title: '^feat(?:\(.+\))?\!?:'
+
+    # Type: Bug fix
+    -   label: "@type/fix"
+        title: '^fix(?:\(.+\))?\!?:'
+
+    # Type: Improvements such as style changes, refactoring, or performance improvements
+    -   label: "@type/improve"
+        title: '^(style|refactor|perf)(?:\(.+\))?\!?:'
+
+    # Type: Dependency changes
+    -   label: "@type/dependency"
+        title: '^(chore|build)(?:\(deps\))?\!?:'
+
+    # Type: Test-related changes
+    -   label: "@type/test"
+        title: '^test(?:\(.+\))?\!?:'
+        files:
+            - "tests/.+"
+            - "spec/.+"
+
+    # Type: Security-related changes
+    -   label: "@type/security"
+        title: '^security(?:\(.+\))?\!?:'
+        files:
+            - "**/security/.+"
+
+    # Issue Type Only: Feature Request
+    -   label: "Feature Request"
+        type: issue
+        title: "^Feature Request:"
+
+    # Issue Type Only: Documentation
+    -   label: "Documentation"
+        type: issue
+        title: "^.*(\b[Dd]ocumentation|doc(s)?\b).*"
+
+    # Issue Type Only: Bug Report
+    -   label: "Bug Report"
+        type: issue
+        title: "^.*(\b[Bb]ug|b(u)?g(s)?\b).*"

.github/dependabot.yml

@@ -0,0 +1,8 @@
+version: 2
+updates:
+    -   package-ecosystem: "github-actions"
+        directory: "/"
+        # Check for updates every Monday
+        schedule:
+            interval: "weekly"
+        open-pull-requests-limit: 10

.github/renovate.json

@@ -0,0 +1,6 @@
+{
+    "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+    "extends": [
+        "config:base"
+    ]
+}

.github/workflows/cd.yml

@@ -0,0 +1,14 @@
+name: CD # Continuous Deployment or Delivery
+
+on:
+    push:
+        # e.g. 1.0.0, v2.0.0, v0.1.0, v0.2.0-alpha, v0.3.0+build-71edf32
+        tags:
+            - '[v]?[0-9]+\.[0-9]+\.[0-9]+.*'
+
+jobs:
+    dd:
+        name: Deploy or Delivery
+        runs-on: ubuntu-latest
+        steps:
+            -   uses: actions/checkout@v4

.github/workflows/ci.yml

@@ -0,0 +1,48 @@
+name: CI # Continuous Integration
+
+on:
+    push:
+        branches:
+            - main
+    pull_request:
+    workflow_dispatch:
+
+
+jobs:
+    build-and-test:
+        name: python-${{ matrix.os }}
+
+        strategy:
+            matrix:
+                os:
+                    - ubuntu-latest
+                    - windows-latest
+                    - macos-latest
+
+            fail-fast: false
+
+        runs-on: ${{ matrix.os }}
+
+        steps:
+            -   uses: actions/checkout@v4
+
+            -   name: Set up uv
+                if: ${{ matrix.os == 'ubuntu-latest' || matrix.os == 'macos-latest' }}
+                run: curl -LsSf https://astral.sh/uv/install.sh | sh
+
+            -   name: Set up uv
+                if: ${{ matrix.os == 'windows-latest' }}
+                run: irm https://astral.sh/uv/install.ps1 | iex
+                shell: powershell
+
+            -   name: Format
+                run: uvx ruff format --diff .
+
+            -   name: Lint
+                run: uvx ruff check .
+
+            -   name: Build & Test
+                run: |
+                    uv sync
+                    uvx hatch build
+                    uvx hatch test

.github/workflows/docker.yml

@@ -0,0 +1,54 @@
+name: Build and Push Docker Image
+
+on:
+    push:
+        tags:
+            - '^v[0-9]+\.[0-9]+\.[0-9]+.*$'
+
+jobs:
+    docker:
+        runs-on: ubuntu-latest
+        steps:
+            -
+                name: Checkout
+                uses: actions/checkout@v4
+            -
+                name: Acquire tag name
+                run: echo "RELEASE_VERSION=${GITHUB_REF_NAME#refs/*/}" >> $GITHUB_ENV
+            -
+                name: Set up QEMU
+                uses: docker/setup-qemu-action@v3
+            -
+                name: Set up Docker Buildx
+                uses: docker/setup-buildx-action@v3
+            -
+                name: Login to GitHub Container Registry
+                uses: docker/login-action@v3
+                with:
+                    registry: ghcr.io
+                    username: ${{ github.repository_owner }}
+                    password: ${{ secrets.GITHUB_TOKEN }}
+            -
+                name: Build and Export to Docker
+                uses: docker/build-push-action@v6
+                with:
+                    context: .
+                    load: true
+                    tags: |
+                        ghcr.io/x-pt/example-py:latest
+                        ghcr.io/x-pt/example-py:${GITHUB_REF_NAME:1}
+            -
+                name: Test it before Push
+                run: |
+                    docker run --rm ghcr.io/x-pt/example-py:latest
+                    docker run --rm ghcr.io/x-pt/example-py:${GITHUB_REF_NAME:1}
+            -
+                name: Build and Push
+                uses: docker/build-push-action@v6
+                with:
+                    context: .
+                    platforms: linux/amd64,linux/arm64
+                    push: true
+                    tags: |
+                        ghcr.io/x-pt/example-py:latest
+                        ghcr.io/x-pt/example-py:${GITHUB_REF_NAME:1}

.github/workflows/labeler.yml

@@ -0,0 +1,15 @@
+name: Labeler
+
+on:
+    - pull_request
+    - issues
+
+jobs:
+    labeler:
+        runs-on: ubuntu-latest
+        steps:
+            -   uses: srvaroa/labeler@master
+                with:
+                    config_path: .github/configs/labeler.yml
+                env:
+                    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/release.yml

@@ -0,0 +1,60 @@
+name: Example Py Release
+
+on:
+    push:
+        tags:
+            - "v*.*.*"
+
+jobs:
+    changelog:
+        runs-on: ubuntu-latest
+        steps:
+            -   name: Checkout Code
+                uses: actions/checkout@v4
+                with:
+                    fetch-depth: 0
+
+            -   name: Get Tag Version
+                id: tag_version
+                run: echo "CURRENT_TAG=${GITHUB_REF#refs/tags/}" >> $GITHUB_ENV
+
+            -   name: Generate Full Changelog
+                uses: orhun/git-cliff-action@v4
+                with:
+                    config: cliff.toml
+                    args: --verbose
+                env:
+                    OUTPUT: CHANGELOG.md
+                    GITHUB_REPO: ${{ github.repository }}
+
+            -   name: Commit Changelog
+                run: |
+                    git config user.name 'github-actions[bot]'
+                    git config user.email 'github-actions[bot]@users.noreply.github.com'
+                    set +e
+                    git switch main
+                    git add CHANGELOG.md
+                    git commit -m "chore(release-bot): prepare for release notes on ${CURRENT_TAG}"
+                    git push
+
+    release:
+        runs-on: ubuntu-latest
+        steps:
+            -   name: Checkout Code
+                uses: actions/checkout@v4
+                with:
+                    fetch-depth: 0
+
+            -   name: Generate Latest Release Notes
+                id: latest_release_notes
+                uses: orhun/git-cliff-action@v4
+                with:
+                    config: cliff.toml
+                    args: --latest --strip all
+                env:
+                    OUTPUT: CHANGELOG.txt
+
+            -   name: Create GitHub Release
+                uses: softprops/action-gh-release@v2
+                with:
+                    body_path: CHANGELOG.txt