Josverl · Copilot · Oct 17, 2025 · Oct 17, 2025 · Oct 17, 2025 · Oct 17, 2025
diff --git a/.coverage b/.coverage
diff --git a/.devcontainer/Dockerfile b/.devcontainer/Dockerfile
diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
diff --git a/.github/workflows/publish_board_comparison_to_pages.yml b/.github/workflows/publish_board_comparison_to_pages.yml
@@ -0,0 +1,115 @@
+name: Publish Board Comparison Tool to GitHub Pages
+
+on:
+  # Run when frontend files are updated
+  push:
+    branches:
+      - main
+    paths:
+      - 'tools/board_compare/frontend/**'
+      - '.github/workflows/publish_board_comparison_to_pages.yml'
+
+  # Allow manual triggering
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Prepare deployment directory
+        run: |
+          mkdir -p _site/board-compare
+          cp -r tools/board_compare/frontend/* _site/board-compare/
+          # Rename board-explorer.html to index.html for default page
+          mv _site/board-compare/board-explorer.html _site/board-compare/index.html
+          # Create a simple index.html in root if needed
+          if [ ! -f "_site/index.html" ]; then
+            cat > _site/index.html << 'EOF'
+          <!DOCTYPE html>
+          <html>
+          <head>
+              <meta charset="UTF-8">
+              <meta name="viewport" content="width=device-width, initial-scale=1.0">
+              <title>MicroPython Stubs</title>
+              <style>
+                  body {
+                      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+                      max-width: 800px;
+                      margin: 50px auto;
+                      padding: 20px;
+                      line-height: 1.6;
+                  }
+                  h1 { color: #2c3e50; }
+                  a {
+                      color: #3498db;
+                      text-decoration: none;
+                      border-bottom: 1px solid #3498db;
+                  }
+                  a:hover { color: #2980b9; }
+                  .tool {
+                      background: #f8f9fa;
+                      border-left: 4px solid #3498db;
+                      padding: 15px;
+                      margin: 20px 0;
+                  }
+              </style>
+          </head>
+          <body>
+              <h1>🐍 MicroPython Stubs</h1>
+              <p>Type stubs and tools for MicroPython development.</p>
+
+              <div class="tool">
+                  <h2><a href="/micropython-stubs/board-compare/">📊 Board Comparison Tool</a></h2>
+                  <p>Compare MicroPython APIs (modules, classes, methods) across different boards and versions.</p>
+                  <p>Features:</p>
+                  <ul>
+                      <li>Board Explorer - View complete API structure for any board</li>
+                      <li>Compare Boards - Side-by-side comparison with diff mode</li>
+                      <li>Search APIs - Find which boards support specific modules/classes</li>
+                  </ul>
+              </div>
+
+              <h2>Resources</h2>
+              <ul>
+                  <li><a href="https://github.com/Josverl/micropython-stubs">GitHub Repository</a></li>
+                  <li><a href="https://github.com/Josverl/micropython-stubber">MicroPython Stubber</a></li>
+              </ul>
+          </body>
+          </html>
+          EOF
+          fi
+          echo "Deployment directory contents:"
+          ls -lR _site/
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+
+  # Deployment job
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
diff --git a/.github/workflows/publish_explorer.yml b/.github/workflows/publish_explorer.yml
@@ -0,0 +1,35 @@
+name: Publish explorer frontend to GitHub Pages
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [  copilot/create-database-viewer-tool] # or main
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      # If you need a build step (npm, make, etc.), add it here.
+      # For example:
+      # - name: Build frontend
+      #   run: |
+      #     cd tools/board_compare/frontend
+      #     npm ci
+      #     npm run build
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: tools/board_compare/frontend
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
diff --git a/.github/workflows/test_board_comparison.yml b/.github/workflows/test_board_comparison.yml
@@ -0,0 +1,77 @@
+name: Test Board Comparison Tools
+
+on:
+  pull_request:
+    paths:
+      - 'tools/board_compare/**'
+      - '.github/workflows/test_board_comparison.yml'
+  push:
+    branches:
+      - main
+    paths:
+      - 'tools/board_compare/**'
+      - '.github/workflows/test_board_comparison.yml'
+  workflow_dispatch:
+
+jobs:
+  test-board-compare:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install pydantic libcst pytest
+
+      - name: Run simple tests
+        working-directory: tools/board_compare
+        run: |
+          python test_tool.py
+
+      - name: Run pytest tests
+        working-directory: tools/board_compare
+        continue-on-error: true
+        run: |
+          pytest -v --tb=short
+
+      - name: Run unified test suite
+        working-directory: tools/board_compare
+        run: |
+          python run_tests.py
+
+      - name: Test database build (dry run)
+        working-directory: tools/board_compare
+        continue-on-error: true
+        run: |
+          # Test that the build_database script can be imported and has no syntax errors
+          python -c "from build_database import DatabaseBuilder; print('✓ build_database.py imports successfully')"
+
+      - name: Test stub scanner (dry run)
+        working-directory: tools/board_compare
+        continue-on-error: true
+        run: |
+          # Test that the scan_stubs script can be imported and has no syntax errors
+          python -c "from scan_stubs import StubScanner; print('✓ scan_stubs.py imports successfully')"
+
+      - name: Verify models
+        working-directory: tools/board_compare
+        run: |
+          python -c "from models import Parameter, Method, Class, Module, Board; print('✓ All models import successfully')"
+
+      - name: Test Summary
+        if: always()
+        run: |
+          echo "================================================"
+          echo "Board Comparison Tool Test Results"
+          echo "================================================"
+          echo "All tests completed. Check logs above for details."
diff --git a/.github/workflows/update_board_comparison.yml b/.github/workflows/update_board_comparison.yml
@@ -0,0 +1,48 @@
+name: Update Board Comparison Database
+
+on:
+  schedule:
+    # Run every Sunday at 2 AM UTC
+    - cron: '0 2 * * 0'
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'MicroPython version to process (e.g., v1_26_0)'
+        required: false
+        default: 'v1_26_0'
+
+jobs:
+  update-database:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        run: |
+          pip install pydantic
+
+      - name: Build database
+        run: |
+          cd tools/board_compare
+          VERSION=${{ github.event.inputs.version || 'v1_26_0' }}
+          python build_database.py \
+            --version $VERSION \
+            --db frontend/board_comparison.db \
+            --json frontend/board_comparison.json
+
+      - name: Commit and push if changed
+        run: |
+          git config --global user.name 'github-actions[bot]'
+          git config --global user.email 'github-actions[bot]@users.noreply.github.com'
+          git add tools/board_compare/frontend/board_comparison.db
+          git add tools/board_compare/frontend/board_comparison.json
+          git diff --quiet && git diff --staged --quiet || (git commit -m "Update board comparison database [automated]" && git push)
diff --git a/.gitignore b/.gitignore
@@ -57,4 +57,13 @@ publish/micropython-stdlib-stubs_100b1
 
 # no test lock files
 **/*_lock.file
-tests/doc_test/micropython/
+tests/doc_test/micropython/
+
+# board comparison database files (generated, except frontend database)
+tools/board_compare/*.db
+tools/board_compare/*.db-journal
+# Allow frontend database for GitHub Pages
+!tools/board_compare/frontend/board_comparison.db
+
+# no screenshots
+.playwright-mcp/*.png
diff --git a/.vscode/.gitignore b/.vscode/.gitignore
@@ -0,0 +1,4 @@
+# Ignore MCP server store configurations to avoid committing sensitive database paths
+stores/
+*store*.json
+*connection*.json
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -107,4 +107,5 @@
     "python.formatting.provider": "none",
     "python.analysis.supportRestructuredText": true,
     "iis.configDir": "",
+    "esbonio.server.enabled": false,
 }