holoviz-mcp 0.0.1a0__tar.gz → 0.0.1a2__tar.gz

holoviz_mcp-0.0.1a2/.copier-answers.yml

@@ -0,0 +1,12 @@
+# This file is managed by Copier; DO NOT EDIT OR REMOVE.
+_commit: ec05cb3
+_src_path: https://github.com/panel-extensions/copier-template-panel-extension
+add_autobump_workflow: true
+author_email: marc.skov.madsen@gmail.com
+author_name: MarcSkovMadsen
+docs_url: https://MarcSkovMadsen.github.io/holoviz-mcp
+github_url: https://github.com/MarcSkovMadsen/holoviz-mcp
+github_user: MarcSkovMadsen
+minimal_python_version: py311
+project_short_description: A Model Context Protocol (MCP) server for the HoloViz ecosystem
+project_slug: holoviz-mcp

holoviz_mcp-0.0.1a2/.gitattributes

@@ -0,0 +1 @@
+pixi.lock linguist-language=YAML linguist-generated=true

holoviz_mcp-0.0.1a2/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @MarcSkovMadsen

holoviz_mcp-0.0.1a2/.github/copilot-instructions.md

@@ -0,0 +1,23 @@
+# HoloViz MCP
+
+This Project provides a Model Context Protocol (MCP) server for the HoloViz ecosystem.
+
+For context please:
+
+- read the README.md
+
+Before developing this project, please #fetch the following:
+
+- https://raw.githubusercontent.com/holoviz/holoviz/refs/heads/main/README.md
+- https://gofastmcp.com/getting-started/welcome.md
+- https://gofastmcp.com/llms.txt
+
+Before adding tests to this project, please #fetch the following:
+
+- https://gofastmcp.com/patterns/testing.md
+
+## Best Practices
+
+- DO Write code and tests and an experienced, lead Python developer would be proud of.
+- DO integration tests instead of mocking out integrations
+- DO use pytest to test. DO not create custom scripts or notebooks.

holoviz_mcp-0.0.1a2/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: monthly
+    groups:
+      gh-actions:
+        patterns:
+          - "*"

holoviz_mcp-0.0.1a2/.github/prompts/developer_guide.prompt.md

@@ -0,0 +1,8 @@
+For context please read :
+
+- the README.md
+
+and #fetch:
+
+- https://gofastmcp.com/getting-started/welcome.md
+- https://gofastmcp.com/patterns/testing.md

holoviz_mcp-0.0.1a2/.github/prompts/holoviz.prompt.md

@@ -0,0 +1,142 @@
+# HoloViz Development Guidelines
+
+## Overview
+
+Use the HoloViz ecosystem including Panel, Param, and hvPlot for building interactive data applications following intermediate to expert patterns.
+
+## Panel Application Development
+
+### Core Architecture Principles
+
+**Parameter-Driven Design**
+
+- Create applications as `param.Parameterized` or `pn.Viewable` classes
+- Let Parameters drive application state, not widgets directly
+- Structure code so user interactions can be tested using Parameterized classes
+- Use a source `data` parameter to drive your app - structure code so app state resets when source data changes
+
+**Widget and Display Patterns**
+
+- Create widgets from parameters: `pn.widgets.Select.from_param(state.param.parameter_name, ...)`
+- Display Parameter objects in panes: `pn.pane.HoloViews(state.param.parameter_name, ...)`
+- Prefer `pn.bind` or `@param.depends` without `watch=True` for reactive updates
+- Use `.on_click` for Button interactions over `watch=True` patterns
+- Avoid `pn.bind` or `@pn.depends` with `watch=True`, `.watch`, or `.link` methods as they make apps harder to reason about
+
+**other**
+
+- prefer using `.servable()` over `.show()` for serving applications
+- use `pn.state.served:` to check if the app is being served instead of `if __name__ == "__main__"
+
+### Code Organization
+
+**Module Structure**
+
+- Put data extractions and transformations in `data.py` - keep clean and reusable without HoloViz dependencies
+- Put plot functions in `plots.py` - keep clean and reusable without Panel code
+- Separate business logic from UI concerns
+
+**Component Selection**
+
+- Use `panel-graphic-walker` package for Tableau-like data exploration components
+- Use `panel-material-ui` components for new projects or projects already using this package
+- Continue using standard Panel components in existing projects that already use them
+
+### Testing Strategy
+
+**Testable Architecture**
+
+- Structure code so user interactions can be tested through Parameterized classes
+- Separate UI logic from business logic to enable unit testing
+- Use parameter watchers and dependencies for reactive behavior that can be tested
+
+## Best Practices
+
+### Reactive Programming
+
+- Prefer declarative reactive patterns over imperative event handling
+- Use `@param.depends` decorators to create reactive methods
+- Leverage parameter watchers for automatic state management
+
+### Performance Considerations
+
+- Use `sizing_mode="stretch_width"` for responsive layouts
+- Avoid unnecessary parameter watchers that could cause performance issues
+- Structure data flows to minimize redundant computations
+
+### Error Handling
+
+- Implement graceful handling of missing or invalid data
+- Provide meaningful feedback to users when operations fail
+- Use safe data access patterns for robust applications
+
+## Example Patterns
+
+### Parameter-Driven Widget Creation
+```python
+# Good: Widget driven by parameter
+select_widget = pn.widgets.Select.from_param(
+    self.param.model_type,
+    name="Model Type"
+)
+
+# Avoid: Manual widget management
+select_widget = pn.widgets.Select(
+    options=['Option1', 'Option2'],
+    value='Option1'
+)
+```
+
+### Reactive Display Updates
+
+```python
+# Best: Depends functions and methods
+@param.depends('model_results')
+def create_plot(self):
+    return create_performance_plot(self.model_results)
+
+plot_pane = pn.pane.Matplotlib(
+    self.create_plot
+)
+
+# Good: Bound functions and methods
+def create_plot(self):
+    return create_performance_plot(self.model_results)
+
+plot_pane = pn.pane.Matplotlib(
+    pn.bind(self.create_plot)
+)
+
+# Avoid: Manual updates with watchers
+def update_plot(self):
+    self.plot_pane.object = create_performance_plot(self.model_results)
+
+self.param.watch(self.update_plot, 'model_results')
+```
+
+### Data-Driven Architecture
+
+```python
+class DataApp(param.Parameterized):
+    data = param.DataFrame(default=pd.DataFrame())
+
+    @param.depends('data', watch=True)
+    def _reset_app_state(self):
+        """Reset all app state when source data changes."""
+        # Reset or update parameters but not widgets directly
+        ...
+
+    @param.depends('data')
+    def _get_xyz(self):
+        """Return some transformed object like a DataFrame or a Plot/ Figure."""
+        # Keep this method short by using imported method from data or plots module
+        ...
+```
+
+## Resources
+
+- [Panel Intermediate Tutorials](https://panel.holoviz.org/tutorials/intermediate/index.html)
+- [Panel Expert Tutorials](https://panel.holoviz.org/tutorials/expert/index.html)
+- [Param Documentation](https://param.holoviz.org/)
+- [Panel Material UI Components](https://panel-material-ui.holoviz.org/)
+- [Panel Graphic Walker](https://panel-graphic-walker.holoviz.org/)

holoviz_mcp-0.0.1a2/.github/prompts/ruff_check.prompt.md

@@ -0,0 +1,17 @@
+When fixing ruff issues, please follow these guidelines below.
+
+Please fix one issue at a time and test the change before progressing to next issue.
+Please fix ruff issues in the 'src' and 'tests' folders only.
+Please fix easy to fix issues before more complex ones.
+For complex ones feel free to ask the user for guidance or help.
+
+## Specific Rules
+
+### D405
+
+Please ensure the docstring change is meaningful to end users and Google style.
+If the summary extends to multiple lines please reformulate instead of breaking the summary into two distinct lines.
+
+### ARG001
+
+If the argument is an unused pytest fixture please change it to a marker, e.g. to `@pytest.mark.usefixtures("name_of_fixture")`.

holoviz_mcp-0.0.1a2/.github/workflows/build.yml

@@ -0,0 +1,45 @@
+name: Build
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+    tags:
+      - "*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        with:
+          fetch-depth: 0
+      - name: Set up pixi
+        uses: prefix-dev/setup-pixi@ba3bb36eb2066252b2363392b7739741bb777659 # v0.8.1
+        with:
+          environments: build
+      - name: Build project
+        run: pixi run -e build build-wheel
+      - name: Check package
+        run: pixi run -e build check-wheel
+      - name: Upload package
+        uses: actions/upload-artifact@b4b15b8c7c6ac21ea08fcf65892d2ee8f75cf882 # v4.4.3
+        with:
+          name: artifact
+          path: dist/*
+
+  release:
+    name: Publish package
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: [build]
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    environment: pypi
+    steps:
+      - uses: actions/download-artifact@fa0a91b85d4f404e444e00e005971372dc801d16 # v4.1.8
+        with:
+          name: artifact
+          path: dist
+      - name: Publish package on PyPi
+        uses: pypa/gh-action-pypi-publish@release/v1

holoviz_mcp-0.0.1a2/.github/workflows/ci.yml

@@ -0,0 +1,170 @@
+name: CI
+on:
+  pull_request:
+    branches:
+      - "*"
+  push:
+    branches:
+      - main
+# Automatically stop old builds on the same branch/PR
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  setup:
+    name: Setup workflow
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: read
+    outputs:
+      code_change: ${{ steps.filter.outputs.code }}
+      matrix: ${{ env.MATRIX }}
+    steps:
+      - uses: actions/checkout@v4
+        if: github.event_name != 'pull_request'
+      - name: Check for code changes
+        uses: dorny/paths-filter@v3
+        id: filter
+        with:
+          filters: |
+            code:
+              - 'src/**'
+              - 'pyproject.toml'
+              - '.github/workflows/ci.yaml'
+      - name: Set matrix option
+        run: |
+          if [[ '${{ github.event_name }}' == 'workflow_dispatch' ]]; then
+            OPTION=${{ github.event.inputs.target }}
+          elif [[ '${{ github.event_name }}' == 'schedule' ]]; then
+            OPTION="full"
+          elif [[ '${{ github.event_name }}' == 'push' && '${{ github.ref_type }}' == 'tag' ]]; then
+            OPTION="full"
+          else
+            OPTION="default"
+          fi
+          echo "MATRIX_OPTION=$OPTION" >> $GITHUB_ENV
+      - name: Set test matrix with 'default' option
+        if: env.MATRIX_OPTION == 'default'
+        run: |
+          MATRIX=$(jq -nsc '{
+              "os": ["ubuntu-latest", "macos-latest", "windows-latest"],
+              "environment": ["test-310", "test-312"],
+          }')
+          echo "MATRIX=$MATRIX" >> $GITHUB_ENV
+      - name: Set test matrix with 'full' option
+        if: env.MATRIX_OPTION == 'full'
+        run: |
+          MATRIX=$(jq -nsc '{
+              "os": ["ubuntu-latest", "macos-latest", "windows-latest"],
+              "environment": ["test-310", "test-311", "test-312"]
+          }')
+          echo "MATRIX=$MATRIX" >> $GITHUB_ENV
+      - name: Set test matrix with 'downstream' option
+        if: env.MATRIX_OPTION == 'downstream'
+        run: |
+          MATRIX=$(jq -nsc '{
+              "os": ["ubuntu-latest"],
+              "environment": ["test-311"]
+          }')
+          echo "MATRIX=$MATRIX" >> $GITHUB_ENV
+
+  pixi_lock:
+    name: Pixi lock
+    runs-on: ubuntu-latest
+    steps:
+      - uses: holoviz-dev/holoviz_tasks/pixi_lock@v0
+        with:
+          cache: ${{ github.event.inputs.cache == 'true' || github.event.inputs.cache == '' }}
+
+  pre-commit:
+    timeout-minutes: 30
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout branch
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - name: Set up pixi
+        uses: prefix-dev/setup-pixi@ba3bb36eb2066252b2363392b7739741bb777659 # v0.8.1
+        with:
+          environments: default lint
+      - name: pre-commit
+        run: pixi run pre-commit-run --color=always --show-diff-on-failure
+  pytest:
+    timeout-minutes: 30
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        environment:
+          - py311
+          - py312
+        os:
+          - ubuntu-latest
+          - macos-latest
+          - windows-latest
+    steps:
+      - name: Checkout branch
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        with:
+          fetch-depth: 0
+      - name: Set up pixi
+        uses: prefix-dev/setup-pixi@ba3bb36eb2066252b2363392b7739741bb777659 # v0.8.1
+        with:
+          environments: ${{ matrix.environment }}
+      - name: Install repository
+        run: pixi run -e ${{ matrix.environment }} postinstall
+      - name: Run pytest
+        run: pixi run -e ${{ matrix.environment }} test-coverage --color=yes
+
+  pytest_ui:
+    name: ui:${{ matrix.environment }}:${{ matrix.os }}
+    needs: [pre-commit, setup, pixi_lock]
+    runs-on: ${{ matrix.os }}
+    if: needs.setup.outputs.code_change == 'true'
+    strategy:
+      fail-fast: false
+      matrix:
+        environment: ["test-ui"]
+        os: ["ubuntu-latest", "macos-latest", "windows-latest"]
+    timeout-minutes: 60
+    env:
+      PANEL_LOG_LEVEL: info
+    steps:
+      - name: Checkout branch
+        uses: actions/checkout@v4.2.2
+        with:
+          fetch-depth: 0
+
+      - name: Set up Pixi
+        uses: prefix-dev/setup-pixi@v0.8.1
+        with:
+          environments: ${{ matrix.environment }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install Dependencies
+        run: |
+          pixi run -e ${{ matrix.environment }} postinstall
+
+      - name: Verify Pixi Installation
+        run: pixi --version
+
+      - name: Configure Coverage
+        run: |
+          echo "[run]" > .uicoveragerc
+          echo "concurrency = greenlet" >> .uicoveragerc
+
+      - name: Test UI
+        run: |
+          FAIL="--screenshot only-on-failure --full-page-screenshot --output ui_screenshots --tracing retain-on-failure"
+          pixi run -e ${{ matrix.environment }} test-ui --cov-config=.uicoveragerc $FAIL
+
+      - name: Upload UI Screenshots
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: ui_screenshots_${{ runner.os }}
+          path: ./ui_screenshots
+          if-no-files-found: ignore

holoviz_mcp-0.0.1a2/.github/workflows/docs.yml

@@ -0,0 +1,55 @@
+name: Build documentation
+
+on:
+  push:
+    branches:
+      - main
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow one concurrent deployment
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+# Default to bash
+defaults:
+  run:
+    shell: bash
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Pixi
+        uses: prefix-dev/setup-pixi@ba3bb36eb2066252b2363392b7739741bb777659 # v0.8.1
+        with:
+          environments: docs
+
+      - name: Build documentation
+        run: pixi run -e docs docs-build
+
+      - name: Upload artifact
+        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
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

holoviz_mcp-0.0.1a2/.github/workflows/update-lockfiles.yml

@@ -0,0 +1,34 @@
+name: Update lockfiles
+permissions:
+  contents: write
+  pull-requests: write
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: 0 5 1 * *
+
+jobs:
+  pixi-update:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - name: Set up pixi
+        uses: prefix-dev/setup-pixi@ba3bb36eb2066252b2363392b7739741bb777659 # v0.8.1
+        with:
+          run-install: false
+      - name: Update lockfiles
+        run: |
+          pixi update --json --no-install | pixi exec pixi-diff-to-markdown >> diff.md
+      - name: Create pull request
+        uses: peter-evans/create-pull-request@5e914681df9dc83aa4e4905692ca88beb2f9e91f # v7.0.5
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: Update pixi lockfile
+          title: Update pixi lockfile
+          body-path: diff.md
+          branch: update-pixi
+          base: main
+          labels: pixi
+          delete-branch: true
+          add-paths: pixi.lock