pyside6-native-titlebar 1.0.0__tar.gz

pyside6_native_titlebar-1.0.0/.editorconfig

@@ -0,0 +1,16 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.py]
+indent_style = space
+indent_size = 4
+max_line_length = 80
+
+[*.{yml,yaml,toml}]
+indent_style = space
+indent_size = 2

pyside6_native_titlebar-1.0.0/.gitattributes

@@ -0,0 +1,8 @@
+* text=auto eol=lf
+*.bat text eol=crlf
+*.cmd text eol=crlf
+*.png binary
+*.jpg binary
+*.ico binary
+*.whl binary
+*.gz binary

pyside6_native_titlebar-1.0.0/.github/actionlint.yaml

@@ -0,0 +1,3 @@
+self-hosted-runner:
+  labels:
+    - desktop

pyside6_native_titlebar-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,68 @@
+name: Library checks
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+  workflow_call:
+    inputs:
+      native_tests:
+        description: Run real HWND tests on a configured desktop runner
+        type: boolean
+        default: false
+  workflow_dispatch:
+    inputs:
+      native_tests:
+        description: Run real HWND tests on a configured desktop runner
+        required: false
+        type: boolean
+        default: false
+
+permissions:
+  contents: read
+
+jobs:
+  portable-tests:
+    runs-on: windows-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ['3.11', '3.12', '3.13', '3.14']
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: "0.12.18"
+      - run: uv sync --locked --python ${{ matrix.python }}
+      - run: uv run pytest -q -m "not windows"
+
+  quality:
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: "0.12.18"
+      - run: uv sync --locked
+      - run: uv run black --check src examples tests tools
+      - run: uv run ruff check .
+      - run: uv run pylint src/native_titlebar examples tests tools
+      - run: uv run mypy
+
+  native-tests:
+    if: github.event_name == 'workflow_dispatch' && inputs.native_tests
+    runs-on: [self-hosted, Windows, X64, desktop]
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: "0.12.18"
+      - run: uv sync --locked
+      - run: uv run python -m native_titlebar
+      - run: uv run pytest -q -m windows --junitxml=artifacts/native-tests.xml
+      - uses: actions/upload-artifact@v7.0.1
+        if: always()
+        with:
+          name: native-test-results
+          path: artifacts/native-tests.xml

pyside6_native_titlebar-1.0.0/.github/workflows/package.yml

@@ -0,0 +1,75 @@
+name: Package
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+  workflow_dispatch:
+  workflow_call:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build and validate distributions
+    runs-on: ubuntu-24.04
+    outputs:
+      wheel_filename: ${{ steps.distribution.outputs.wheel_filename }}
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+      - name: Set up uv
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: "0.12.18"
+          enable-cache: true
+      - name: Install release tools
+        run: uv sync --locked --only-group dev
+      - name: Build wheel and source distribution
+        run: uv build --no-sources
+      - name: Check package metadata and README
+        run: uv run --no-sync twine check --strict dist/*
+      - name: Resolve wheel filename
+        id: distribution
+        shell: bash
+        run: |
+          shopt -s nullglob
+          wheels=(dist/*.whl)
+          test "${#wheels[@]}" -eq 1
+          echo "wheel_filename=$(basename "${wheels[0]}")" >> "$GITHUB_OUTPUT"
+      - name: Upload distributions
+        uses: actions/upload-artifact@v7.0.1
+        with:
+          name: distributions
+          path: dist/*
+          if-no-files-found: error
+          retention-days: 14
+
+  install:
+    name: Install on Windows / Python ${{ matrix.python }}
+    needs: build
+    runs-on: windows-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ['3.11', '3.12', '3.13', '3.14']
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+      - name: Set up uv
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: "0.12.18"
+          enable-cache: true
+      - name: Download verified distributions
+        uses: actions/download-artifact@v8.0.1
+        with:
+          name: distributions
+          path: dist
+      - name: Test the installed wheel without the source checkout
+        run: >-
+          uv run --isolated --no-project --python "${{ matrix.python }}"
+          --with "./dist/${{ needs.build.outputs.wheel_filename }}"
+          python tools/package_smoke.py

pyside6_native_titlebar-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,92 @@
+name: Release
+
+on:
+  push:
+    tags: ['v*']
+  workflow_dispatch:
+    inputs:
+      version:
+        description: Package version to publish, with an optional v prefix
+        required: true
+        type: string
+
+permissions:
+  contents: read
+
+concurrency:
+  group: pypi-release
+  cancel-in-progress: false
+
+jobs:
+  validate:
+    name: Validate release version
+    runs-on: ubuntu-24.04
+    outputs:
+      prerelease: ${{ steps.version.outputs.prerelease }}
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+      - name: Set up uv
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: "0.12.18"
+          enable-cache: true
+      - name: Install release tools
+        run: uv sync --locked --only-group dev
+      - name: Match tag or input to the package version
+        id: version
+        env:
+          RELEASE_VERSION: ${{ github.event_name == 'workflow_dispatch' && inputs.version || github.ref_name }}
+        run: uv run --no-sync python tools/check_release_version.py "$RELEASE_VERSION"
+
+  ci:
+    name: Required quality checks
+    needs: validate
+    uses: ./.github/workflows/ci.yml
+
+  package:
+    name: Required package checks
+    needs: validate
+    uses: ./.github/workflows/package.yml
+
+  publish:
+    name: Publish to PyPI
+    needs: [ci, package]
+    runs-on: ubuntu-24.04
+    environment:
+      name: pypi
+      url: https://pypi.org/project/pyside6-native-titlebar/
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Download verified distributions
+        uses: actions/download-artifact@v8.0.1
+        with:
+          name: distributions
+          path: dist
+      - name: Publish with PyPI Trusted Publishing
+        uses: pypa/gh-action-pypi-publish@v1.14.2
+        with:
+          packages-dir: dist/
+
+  github-release:
+    name: Create GitHub release
+    if: github.event_name == 'push'
+    needs: [validate, publish]
+    runs-on: ubuntu-24.04
+    permissions:
+      contents: write
+    steps:
+      - name: Download published distributions
+        uses: actions/download-artifact@v8.0.1
+        with:
+          name: distributions
+          path: dist
+      - name: Create release and attach distributions
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          fail_on_unmatched_files: true
+          generate_release_notes: true
+          prerelease: ${{ needs.validate.outputs.prerelease == 'true' }}

pyside6_native_titlebar-1.0.0/.gitignore

@@ -0,0 +1,50 @@
+# Python environments and bytecode
+.venv/
+venv/
+env/
+__pypackages__/
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Build and packaging outputs
+build/
+dist/
+*.egg-info/
+.eggs/
+*.egg
+
+# Test, lint, and type-check caches
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.pyre/
+.pytype/
+.tox/
+.nox/
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+junit*.xml
+
+# Local diagnostics and research
+/artifacts/
+/.research/
+*.log
+
+# Local credentials and settings
+.env
+.env.*
+!.env.example
+*.local
+
+# Editors and operating systems
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.DS_Store
+Thumbs.db
+Desktop.ini

pyside6_native_titlebar-1.0.0/.pre-commit-config.yaml

@@ -0,0 +1,27 @@
+repos:
+  - repo: local
+    hooks:
+      - id: black
+        name: Black (80 columns)
+        entry: uv run black --check src examples tests tools
+        language: system
+        pass_filenames: false
+        types: [python]
+      - id: ruff
+        name: Ruff and Google docstrings
+        entry: uv run ruff check .
+        language: system
+        pass_filenames: false
+        types: [python]
+      - id: pylint
+        name: Google Pylint
+        entry: uv run pylint src/native_titlebar examples tests tools
+        language: system
+        pass_filenames: false
+        types: [python]
+      - id: mypy
+        name: Project type checking
+        entry: uv run mypy
+        language: system
+        pass_filenames: false
+        types: [python]