atopile 0.3.0.dev0__tar.gz → 0.3.7.dev0__tar.gz

atopile-0.3.7.dev0/.git-blame-ignore-revs

@@ -0,0 +1,8 @@
+# Migrate code style to Black
+62b92558e887b97ac43e2feafa011cca094a8d68
+# Add black as pre-commit hook and rerun
+94fc4f83209d85eb6f7987a083a17a68a5acaedd
+# isort & autoflake
+406891587843ad51d856922cde2b8dc79c0c406a
+# Faebryk merger
+1129da0d727f3589d7d2ea3112aa94667fcb1488

atopile-0.3.7.dev0/.gitattributes

@@ -0,0 +1,18 @@
+uv.lock linguist-generated=true
+
+*.kicad_* linguist-generated=true
+*.step linguist-generated=true
+*.wrl linguist-generated=true
+*.dxf linguist-generated=true
+*.svg linguist-generated=true
+*.net linguist-generated=true
+
+# Generated by ANTLR4
+src/atopile/parser/AtoLexer.py linguist-generated=true
+src/atopile/parser/AtoParser.interp linguist-generated=true
+src/atopile/parser/AtoParser.tokens linguist-generated=true
+src/atopile/parser/AtoParserListener.py linguist-generated=true
+src/atopile/parser/AtoLexer.interp linguist-generated=true
+src/atopile/parser/AtoLexer.tokens linguist-generated=true
+src/atopile/parser/AtoParser.py linguist-generated=true
+src/atopile/parser/AtoParserVisitor.py linguist-generated=true

atopile-0.3.7.dev0/.github/CODEOWNERS

@@ -0,0 +1,32 @@
+# Lines starting with '#' are comments.
+# Each line is a file pattern followed by one or more owners.
+
+# More details are here: https://help.github.com/articles/about-codeowners/
+
+# The '*' pattern is global owners.
+
+# Order is important. The last matching pattern has the most precedence.
+# The folders are ordered as follows:
+
+# In each subsection folders are ordered first by depth, then alphabetically.
+# This should make it easy to add new rules without breaking existing ones.
+
+# Global rule:
+*       @iopapamanoglou @mawildoer
+
+# faebryk
+src/faebryk @iopapamanoglou
+
+# core
+src/faebryk/core @iopapamanoglou
+
+# stdlib
+src/faebryk/library @napowderly
+
+# picker
+src/faebryk/libs/picker @sam-mellor
+
+# ato dsl
+src/atopile @mawildoer
+
+

atopile-0.3.7.dev0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,60 @@
+name: 🐞 Bug Report
+description: File a bug report
+title: "<title>"
+labels: ["🛠 goal: bug fix"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report! Please fill in the following form in detail.
+  - type: textarea
+    id: current_behaviour
+    attributes:
+      label: Current Behaviour
+      description: Describe what went wrong including the steps to reproduce this bug.
+      placeholder: Tell us what you see!
+      value: "An exeption occured at line 201 in faebryk/exporters/netlist/kicad/netlist.py when running samples/experiment.py"
+    validations:
+      required: true
+  - type: textarea
+    id: expected_behaviour
+    attributes:
+      label: Expected Behaviour
+      description: What did you expect to happen?
+      placeholder: Tell us what you see!
+      value: "The program exited with all checks \"ok\""
+    validations:
+      required: true
+  - type: textarea
+    id: possible_solution
+    attributes:
+      label: Possible Solution
+      description: What might be a solution to this bug?
+      placeholder: Tell us if you know a solution or have a pr!
+      value: "#pr number"
+    validations:
+      required: false
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      description: What version/branch/pr of our software are you running?
+      placeholder: 1.0.0
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant log output
+      description: Please copy and paste any relevant log output. This will be automatically formatted into code, so no need for backticks.
+      render: shell
+    validations:
+      required: false
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Code of Conduct
+      description: By submitting this issue, you agree to follow our [Code of Conduct](/atopile/atopile/blob/main/docs/CODE_OF_CONDUCT.md)
+      options:
+        - label: I agree to follow this project's Code of Conduct
+          required: true

atopile-0.3.7.dev0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Support via Discord
+    url: https://discord.gg/nkpC7wYRVw
+    about: Please ask and answer questions here.

atopile-0.3.7.dev0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,26 @@
+name: 🔮 Feature Request
+description: File a feature request
+title: "<title>"
+labels: ["⭐ goal: addition"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for sharing your amazing idea with us! Please fill in the following form in detail.
+  - type: textarea
+    id: feature
+    attributes:
+      label: Feature Request
+      description: Describe your great idea.
+      placeholder: Tell us all about it!
+      value: "Add an interactive method to connect components to eachother"
+    validations:
+      required: true
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Code of Conduct
+      description: By submitting this issue, you agree to follow our [Code of Conduct](/atopile/atopile/blob/main/docs/CODE_OF_CONDUCT.md)
+      options:
+        - label: I agree to follow this project's Code of Conduct
+          required: true

atopile-0.3.7.dev0/.github/dependabot.yml

@@ -0,0 +1,36 @@
+version: 2
+updates:
+  - package-ecosystem: 'github-actions'
+    directory: "/"
+    schedule:
+      interval: weekly
+    labels:
+      - 'no-changelog'
+
+  - package-ecosystem: 'pip'
+    directory: /
+    schedule:
+      interval: daily
+    labels:
+      - 'no-changelog'
+
+  - package-ecosystem: 'pip'
+    directory: /src/vscode-atopile/
+    schedule:
+      interval: daily
+    labels:
+      - 'debt'
+    commit-message:
+      include: 'scope'
+      prefix: 'pip'
+
+  - package-ecosystem: 'npm'
+    directory: /src/vscode-atopile/
+    schedule:
+      interval: monthly
+    labels:
+      - 'no-changelog'
+    ignore:
+      - dependency-name: '@types/vscode'
+      - dependency-name: '@types/node'
+      - dependency-name: 'vscode-languageclient'

atopile-0.3.7.dev0/.github/pull_request_template.md

@@ -0,0 +1,19 @@
+# \<Prefix\>: \<Title\>
+
+# Description
+
+Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context. List any dependencies that are required for this change.
+
+Fixes # (issue)
+
+# Checklist
+
+Please read and execute the following:
+
+- [ ] My code follows the [coding guidelines](/faebryk/faebryk/blob/main/docs/CODING_GUIDELINES.md) of this project
+- [ ] I have performed a self-review of my own code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation (if applicable)
+- [ ] My changes generate no new warnings
+- [ ] I have added tests that prove my fix is effective or that my feature works (if applicable)
+- [ ] Any dependent changes have been merged and published in downstream modules

{atopile-0.3.0.dev0 → atopile-0.3.7.dev0}/.github/workflows/cd.yml

@@ -1,19 +1,49 @@
 name: Continuous Delivery
 
 on:
-  push:
-    branches:
-      - 'main'
-    tags:
-      - 'v*'
+  workflow_dispatch:
   pull_request:
+  push:
     branches:
-      - 'main'
+      - main
 
 jobs:
-  python:
+  python-build:
     runs-on: ubuntu-latest
 
+    steps:
+      - uses: actions/checkout@v4
+
+      # Required due to a bug in the checkout action
+      # https://github.com/actions/checkout/issues/1471
+      - run: git fetch --prune --unshallow --tags
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: 'pyproject.toml'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: '0.5.5'
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Make python package
+        run: uv build
+
+      - name: Upload Python Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package
+          path: dist
+
+  python-publish:
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags')
+    needs: python-build
+
     environment:
       name: pypi
       url: https://pypi.org/p/atopile/
@@ -25,46 +55,24 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      # Required due to a bug in the checkout action
-      # https://github.com/actions/checkout/issues/1471
-      - run: git fetch --prune --unshallow --tags
-
-      -
-        name: Set up Python
-        uses: actions/setup-python@v2
-        with:
-          python-version: '3.11'
-
-      -
-        name: Make python package
-        run: |
-          pip install build twine
-          python -m build
-
-      -
-        name: Upload Python Artifact
-        uses: actions/upload-artifact@v2
+      - name: Download python-package
+        uses: actions/download-artifact@v4
         with:
           name: python-package
           path: dist
 
-      -
-        name: Publish package distributions to PyPI
-        if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags')
-        uses: pypa/gh-action-pypi-publish@2f6f737ca5f74c637829c0f5c3acd0e29ea5e8bf
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@v1
         with:
           skip-existing: true  # Helpful while we're migrating
 
   docker:
     runs-on: ubuntu-latest
-
-    needs: python
+    needs: python-build
 
     strategy:
       matrix:
         include:
-          - dockerfile: "Dockerfile.ci"
-            image: "atopile-ci"
           - dockerfile: "Dockerfile.kicad"
             image: "atopile-kicad"
 
@@ -77,57 +85,40 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      -
-        name: Download python-package
-        uses: actions/download-artifact@v2
+      - name: Download python-package
+        uses: actions/download-artifact@v4
         with:
           name: python-package
           path: dist
 
-      -
-        name: Docker meta
+      - name: Docker meta
         id: meta
         uses: docker/metadata-action@v5
         with:
           images: |
             ghcr.io/atopile/${{ matrix.image }}
+          # TODO: re-enable @latest tag once main is stable again (@v0.3)
+          flavor: |
+            latest=false
           tags: |
             type=ref,event=branch
             type=ref,event=pr
             type=semver,pattern={{version}}
             type=semver,pattern={{major}}.{{minor}}
+            type=sha
 
-      -
-        name: Log in to the Container registry
-        uses: docker/login-action@65b78e6e13532edd9afa3aa52ac7964289d1a9c1
+      - name: Log in to the Container registry
+        uses: docker/login-action@0d4c9c5ea7693da7b068278f7b52bda2a190a446
         with:
           registry: ghcr.io
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
-      -
-        name: Build and push
-        uses: docker/build-push-action@v5
+      - name: Build and push
+        uses: docker/build-push-action@v6
         with:
           context: .
           file: dockerfiles/${{ matrix.dockerfile }}
           push: true
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}
-
-  # vscode: TODO:
-  #   runs-on: ubuntu-latest
-  #   steps:
-  #     - uses: actions/checkout@v4
-
-  #     - uses: actions/setup-node@v1
-  #       with:
-  #         node-version: 20
-
-  #     - run: npm ci
-
-  #     - name: Publish to Visual Studio Marketplace
-  #       uses: HaaLeo/publish-vscode-extension@v1
-  #       with:
-  #         pat: ${{ secrets.VS_MARKETPLACE_TOKEN }}
-  #         registryUrl: https://marketplace.visualstudio.com

atopile-0.3.7.dev0/.github/workflows/pre-commit.yml

@@ -0,0 +1,20 @@
+name: pre-commit
+
+on:
+  push:
+
+jobs:
+  pre-commit:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - uses: actions/setup-python@v5
+      with:
+        python-version-file: 'pyproject.toml'
+
+    - uses: pre-commit/action@v3.0.1
+
+    - name: Fail on diff after pre-commit is run
+      run: git diff --exit-code

atopile-0.3.7.dev0/.github/workflows/pytest.yml

@@ -0,0 +1,57 @@
+name: pytest
+
+on:
+  push:
+
+jobs:
+  pytest:
+    runs-on: blacksmith-8vcpu-ubuntu-2204
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    # Required due to a bug in the checkout action
+    # https://github.com/actions/checkout/issues/1471
+    - run: git fetch --prune --unshallow --tags
+
+    - name: Install uv
+      uses: useblacksmith/setup-uv@v4
+      with:
+        version: 0.5.5
+        enable-cache: true
+        cache-dependency-glob: "uv.lock"
+
+    - name: "Set up Python"
+      uses: useblacksmith/setup-python@v6
+      with:
+        python-version-file: "pyproject.toml"
+
+    - name: Setup cmake
+      uses: jwlawson/actions-setup-cmake@v2
+
+    - name: Run pytest
+      id: pytest
+      continue-on-error: true
+      run: |
+        uv run --dev --no-editable --frozen pytest -m "not not_in_ci and not slow and not regression" --timeout=300
+      env:
+        COLUMNS: 150  # rich console width will be pulled from this
+
+    - name: Upload all test logs
+      if: steps.pytest.outcome == 'failure'
+      uses: actions/upload-artifact@v4
+      with:
+        name: test-logs
+        path: artifacts/**/*.log
+        if-no-files-found: warn
+
+    - name: Upload all test report
+      if: steps.pytest.outcome == 'failure'
+      uses: actions/upload-artifact@v4
+      with:
+        name: test-report
+        path: artifacts/test-report.html
+
+    - name: Check pytest status
+      if: steps.pytest.outcome == 'failure'
+      run: exit 1

atopile-0.3.7.dev0/.github/workflows/regression.yml

@@ -0,0 +1,94 @@
+name: regression
+
+on:
+  push:
+    branches: [main]  # Adjust this if your default branch has a different name
+  pull_request:
+    types: [opened, synchronize, reopened, labeled]
+  workflow_dispatch:  # Add manual trigger capability
+
+jobs:
+  regression:
+    runs-on: blacksmith-4vcpu-ubuntu-2204
+    if: ${{
+        (github.event_name == 'pull_request' && contains(github.event.pull_request.labels.*.name, 'regression-required')) ||
+        (github.event_name == 'push' || github.event_name == 'workflow_dispatch')
+      }}
+    steps:
+    # FIXME: remove this once we're done debugging
+    - run: echo "Event " ${{ github.event_name }}
+    - run: echo "Event labels " ${{ github.event.pull_request.labels }}
+    - run: echo "run for pull_request " ${{ (github.event_name == 'pull_request' && contains(github.event.pull_request.labels.*.name, 'regression-required')) }}
+    - run: echo "run else " ${{ (github.event_name == 'push' || github.event_name == 'workflow_dispatch') }}
+
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    # Required due to a bug in the checkout action
+    # https://github.com/actions/checkout/issues/1471
+    - run: git fetch --prune --unshallow --tags
+
+    - name: Install uv
+      uses: useblacksmith/setup-uv@v4
+      with:
+        version: 0.5.5
+        enable-cache: true
+        cache-dependency-glob: "uv.lock"
+
+    - name: "Set up Python"
+      uses: useblacksmith/setup-python@v6
+      with:
+        python-version-file: "pyproject.toml"
+
+    - name: Setup cmake
+      uses: jwlawson/actions-setup-cmake@v2
+
+    - name: Configure AWS Credentials
+      uses: aws-actions/configure-aws-credentials@v4
+      with:
+        aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
+        aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+        aws-region: ${{ secrets.AWS_REGION }}
+
+    # TODO: remove dependency on global fp-lib-table
+    - name: Prepare test environment
+      run: |
+        mkdir -p ~/.config/kicad/8.0/
+        aws s3 cp "s3://${{ secrets.TEST_DATASET_BUCKET }}/kicad-8.0-fp-lib-table" ~/.config/kicad/8.0/fp-lib-table
+
+        mkdir -p /usr/share/kicad/
+        aws s3 cp "s3://${{ secrets.TEST_DATASET_BUCKET }}/kicad-8.0-footprints.tar.gz" - | tar -xz -C /usr/share/kicad/
+
+    - name: Run pytest
+      id: pytest
+      continue-on-error: true
+      # Regular tests are run as part of the pytest workflow
+      run: |
+        uv run --dev --no-editable --frozen pytest -m "not not_in_ci and regression" --timeout=900
+      env:
+        GH_TOKEN: ${{ github.token }}
+        PYTEST_HISTORY_EMAIL: ${{ vars.PYTEST_HISTORY_EMAIL }}
+        PYTEST_HISTORY_PASSWORD: ${{ secrets.PYTEST_HISTORY_PASSWORD }}
+        COLUMNS: 150  # rich console width will be pulled from this
+
+    - name: Upload all test artifacts
+      if: steps.pytest.outcome == 'failure'
+      uses: actions/upload-artifact@v4
+      with:
+        name: test-artifacts
+        path: artifacts/**
+        if-no-files-found: warn
+
+    # Upload the report as a separate artifact
+    # to make it easier to find since it's typically
+    # the first place we look for the failure
+    - name: Upload all test report
+      if: steps.pytest.outcome == 'failure'
+      uses: actions/upload-artifact@v4
+      with:
+        name: test-report
+        path: artifacts/test-report.html
+
+    - name: Check pytest status
+      if: steps.pytest.outcome == 'failure'
+      run: exit 1

atopile-0.3.7.dev0/.github/workflows/vsx.yml

@@ -0,0 +1,45 @@
+name: Release VSCode Extension
+
+on:
+  push:
+    tags:
+      - 'v[0-9]+.[0-9]+.[0-9]+'
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to release'
+        required: true
+        type: string
+
+jobs:
+  vsx-extension:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: src/vscode-atopile
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - run: npm ci
+
+      # Set the version in package.json from a workflow dispatch input
+      - run: npm version --no-git-tag-version ${{ inputs.version }}
+        if: github.event_name == 'workflow_dispatch'
+      # Otherwise use the tag name
+      - run: npm version --no-git-tag-version ${{ github.ref_name }}
+        if: github.event_name == 'push'
+
+      - name: Publish to VS Code Marketplace
+        # Skip duplicate here to allow manual triggering
+        run: npx vsce publish --skip-duplicate
+        env:
+          VSCE_PAT: ${{ secrets.VSCE_PAT }}
+
+      - name: Publish to Open VSX
+        run: npx ovsx publish --skip-duplicate
+        env:
+          OVSX_PAT: ${{ secrets.OVSX_PAT }}

{atopile-0.3.0.dev0 → atopile-0.3.7.dev0}/.github/workflows/website.yml

@@ -10,20 +10,31 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+
       - name: Configure Git Credentials
         run: |
           git config user.name github-actions[bot]
           git config user.email 41898282+github-actions[bot]@users.noreply.github.com
-      - uses: actions/setup-python@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
         with:
-          python-version: 3.x
-      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV 
-      - uses: actions/cache@v3
+          python-version-file: 'pyproject.toml'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: '0.5.5'
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+
+      - uses: actions/cache@v4
         with:
           key: mkdocs-material-${{ env.cache_id }}
           path: .cache
           restore-keys: |
             mkdocs-material-
-      - run: pip install mkdocs-material
-      - run: pip install mkdocs-drawio-file
-      - run: mkdocs gh-deploy --force
+
+      - run: uv run --dev mkdocs gh-deploy --force