build123d-techdraw 0.1.0__tar.gz

build123d_techdraw-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,35 @@
+name: Bug Report
+description: Create a report to help us improve build123d-techdraw
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug! Please fill out the sections below.
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear and concise description of what the bug is.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Minimal Reproducible Example
+      description: Please provide a self-contained Python script using build123d-techdraw reproducing the issue.
+      render: python
+    validations:
+      required: true
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment Info
+      description: |
+        - Python version (`python --version`)
+        - build123d version (`pip show build123d`)
+        - build123d-techdraw version (`pip show build123d-techdraw`)
+        - OS (Ubuntu, Windows WSL, macOS, etc.)
+    validations:
+      required: true

build123d_techdraw-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,28 @@
+name: Feature Request
+description: Suggest an idea or enhancement for build123d-techdraw
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for suggesting an idea! Please explain your use case and desired API.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem or Motivation
+      description: Is your feature request related to a problem or missing standard drafting capability?
+    validations:
+      required: true
+  - type: textarea
+    id: proposed-solution
+    attributes:
+      label: Proposed Solution / API
+      description: Describe what the solution or Python API would look like.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Any alternative solutions or features you've considered.

build123d_techdraw-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,23 @@
+## Summary of Changes
+
+A clear and concise description of what this PR accomplishes.
+
+## Related Issues
+
+Closes #
+
+## Type of Change
+
+- [ ] `feat`: New feature (non-breaking change which adds functionality)
+- [ ] `fix`: Bug fix (non-breaking change which fixes an issue)
+- [ ] `docs`: Documentation updates or additions
+- [ ] `refactor`: Code change that neither fixes a bug nor adds a feature
+- [ ] `test`: Adding missing tests or correcting existing tests
+- [ ] `chore`: Changes to build process, tooling, or CI
+
+## Checklist
+
+- [ ] My code adheres to the project's styling and type safety standards (`uv run ruff check` and `uv run ruff format --check`).
+- [ ] Full static typing added and verified (`uv run mypy src`).
+- [ ] All new and existing tests pass locally (`uv run pytest`).
+- [ ] Documentation updated where appropriate.

build123d_techdraw-0.1.0/.github/dependabot.yml

@@ -0,0 +1,15 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: "chore(ci)"
+
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: "chore(deps)"

build123d_techdraw-0.1.0/.github/release.yml

@@ -0,0 +1,32 @@
+changelog:
+  categories:
+    - title: "🚀 Features"
+      labels:
+        - "feature"
+        - "enhancement"
+      keywords:
+        - "feat"
+        - "feature"
+    - title: "🐛 Bug Fixes"
+      labels:
+        - "bug"
+        - "fix"
+      keywords:
+        - "fix"
+    - title: "📖 Documentation"
+      labels:
+        - "documentation"
+        - "docs"
+      keywords:
+        - "docs"
+    - title: "🔧 Maintenance & Internal"
+      labels:
+        - "chore"
+        - "refactor"
+        - "ci"
+        - "dependencies"
+      keywords:
+        - "chore"
+        - "refactor"
+        - "test"
+        - "ci"

build123d_techdraw-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,67 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - name: Set up Python
+        run: uv python install 3.12
+      - name: Lint with ruff
+        run: uv run ruff check --output-format=github .
+      - name: Format check with ruff
+        run: uv run ruff format --check .
+
+  type-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - name: Set up Python
+        run: uv python install 3.12
+      - name: Install dependencies
+        run: uv sync --all-groups
+      - name: Run mypy
+        run: uv run mypy src
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v7
+      - name: Install system dependencies for OCP / OpenGL
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libgl1 libegl1 libxrender1 libxcursor1 libxft2 libxinerama1
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: uv sync --all-groups --python ${{ matrix.python-version }}
+      - name: Run tests with pytest
+        run: uv run --python ${{ matrix.python-version }} pytest

build123d_techdraw-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,74 @@
+name: Docs
+
+on:
+  push:
+    branches: [main, master]
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - "src/**"
+      - "pyproject.toml"
+      - ".github/workflows/docs.yml"
+  pull_request:
+    branches: [main, master]
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - "src/**"
+      - "pyproject.toml"
+      - ".github/workflows/docs.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Install system dependencies for OCP / OpenGL
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libgl1 libegl1 libxrender1 libxcursor1 libxft2 libxinerama1
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --group docs --group dev
+
+      - name: Build documentation
+        run: uv run mkdocs build --strict
+
+      - name: Upload Pages artifact
+        if: github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    if: github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

build123d_techdraw-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,110 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: "Dry run (build and validate only, do not publish to PyPI)"
+        required: true
+        type: boolean
+        default: false
+
+permissions:
+  contents: write
+  id-token: write
+  attestations: write
+
+jobs:
+  validate-and-build:
+    name: Validate and Build Package
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - name: Install system dependencies for OCP / OpenGL
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libgl1 libegl1 libxrender1 libxcursor1 libxft2 libxinerama1
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --all-groups
+
+      - name: Run linter and format checks
+        run: |
+          uv run ruff check .
+          uv run ruff format --check .
+
+      - name: Run type checks
+        run: uv run mypy src
+
+      - name: Run test suite
+        run: uv run pytest
+
+      - name: Build wheel and source distribution
+        run: uv build
+
+      - name: Validate distribution artifacts
+        run: uv run twine check dist/*
+
+      - name: Generate build provenance attestations
+        uses: actions/attest-build-provenance@v4
+        if: github.event_name == 'release'
+        with:
+          subject-path: 'dist/*'
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: python-package-distributions
+          path: dist/
+          retention-days: 7
+
+  publish-pypi:
+    name: Publish to PyPI
+    needs: [validate-and-build]
+    runs-on: ubuntu-latest
+    if: github.event_name == 'release' || (github.event_name == 'workflow_dispatch' && !inputs.dry_run)
+    environment:
+      name: pypi
+      url: https://pypi.org/p/build123d-techdraw
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish to PyPI via Trusted Publishing (OIDC)
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+
+  attach-github-release:
+    name: Attach Assets to GitHub Release
+    needs: [validate-and-build]
+    runs-on: ubuntu-latest
+    if: github.event_name == 'release'
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Upload release assets to GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*

build123d_techdraw-0.1.0/.github/workflows/semantic-pr.yml

@@ -0,0 +1,35 @@
+name: "Lint Pull Request"
+
+on:
+  pull_request_target:
+    types:
+      - opened
+      - edited
+      - synchronize
+      - reopened
+
+permissions:
+  pull-requests: read
+
+jobs:
+  validate-pr-title:
+    name: Validate Conventional Commit PR Title
+    runs-on: ubuntu-latest
+    steps:
+      - uses: amannn/action-semantic-pull-request@v5
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          types: |
+            feat
+            fix
+            docs
+            style
+            refactor
+            perf
+            test
+            build
+            ci
+            chore
+            revert
+          requireScope: false

build123d_techdraw-0.1.0/.gitignore

@@ -0,0 +1,56 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+src/build123d_techdraw/_version.py
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Testing & Coverage
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+
+# Documentation
+site/
+.cache/
+
+# Linters & Type Checking
+.mypy_cache/
+.ruff_cache/
+
+
+# IDE & OS
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store

build123d_techdraw-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-added-large-files
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

build123d_techdraw-0.1.0/.python-version

@@ -0,0 +1 @@
+3.14

build123d_techdraw-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,76 @@
+# Contributing to build123d-techdraw
+
+Thank you for your interest in contributing to `build123d-techdraw`!
+
+---
+
+## 🛠️ Development Setup
+
+We use [`uv`](https://github.com/astral-sh/uv) for fast, deterministic Python environment and dependency management.
+
+```bash
+# Clone the repository
+git clone https://github.com/szubster/build123d-techdraw.git
+cd build123d-techdraw
+
+# Install dependencies into virtual environment
+uv sync --all-groups
+
+# Run tests
+uv run pytest
+
+# Run linter & formatter
+uv run ruff check
+uv run ruff format --check
+
+# Run static type checker
+uv run mypy src
+```
+
+---
+
+## 📝 Conventional Commits & Release Management
+
+We follow the [Conventional Commits](https://www.conventionalcommits.org/) specification (v1.0.0). Every commit message and pull request title must follow this format:
+
+```text
+<type>(<scope>): <short description>
+```
+
+### Allowed Types
+- **`feat:`** A new feature (triggers a MINOR version bump).
+- **`fix:`** A bug fix (triggers a PATCH version bump).
+- **`docs:`** Documentation changes.
+- **`refactor:`** Code changes that neither fix a bug nor add a feature.
+- **`test:`** Adding or refactoring tests.
+- **`chore:`** Maintenance, build configuration, or dependency updates.
+- **`ci:`** Changes to GitHub Actions or CI scripts.
+
+### Breaking Changes
+Indicate breaking changes with a `!` after the type/scope (e.g., `feat(core)!: change projection API signature`) or by including `BREAKING CHANGE:` in the commit footer. This triggers a MAJOR version bump.
+
+### Examples
+- `feat(core): add ISO A3 and A4 sheet templates with border markings`
+- `fix(renderers): correct line cap styling in dark blueprint SVG export`
+- `docs: add interactive preview examples to README`
+- `test(dimensions): add test coverage for diameter callout geometry`
+
+---
+
+## 🧪 Testing & Code Quality Requirements
+
+Before submitting a pull request, ensure all checks pass:
+
+1. **Linting & Formatting:**
+   ```bash
+   uv run ruff check --fix
+   uv run ruff format
+   ```
+2. **Type Checking:** Full strict type annotations are required on all public classes, functions, and module interfaces:
+   ```bash
+   uv run mypy src
+   ```
+3. **Tests & Coverage:**
+   ```bash
+   uv run pytest
+   ```