nb-nebi-kernels 0.1__tar.gz

nb_nebi_kernels-0.1/.gitattributes

@@ -0,0 +1,2 @@
+# SCM syntax highlighting & preventing 3-way merges
+pixi.lock merge=binary linguist-language=YAML linguist-generated=true

nb_nebi_kernels-0.1/.github/workflows/release.yaml

@@ -0,0 +1,76 @@
+name: Test & Publish PyPI release
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  test-pypi:
+    name: Test PyPI release
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Upgrade pip
+        run: python -m pip install --upgrade pip build
+
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Create tag
+        # if present, remove leading `v`
+        run: |
+          echo "RELEASE_TAG=$(git describe --tags | sed 's/^v//')" >> $GITHUB_ENV
+          echo ${{ env.RELEASE_TAG }}
+
+      - name: Build source and binary
+        run: python -m build --sdist --wheel .
+
+      - name: Publish to Test PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+      - name: Sleep
+        run: sleep 120
+
+      - name: Test install from Test PyPI
+        run: |
+          pip install \
+          --index-url https://test.pypi.org/simple/ \
+          --extra-index-url https://pypi.org/simple \
+          nb-nebi-kernels==${{ env.RELEASE_TAG }}
+
+  release-pypi:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: test-pypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Upgrade pip
+        run: python -m pip install --upgrade pip build
+
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Build source and binary
+        run: python -m build --sdist --wheel .
+
+      - name: Publish package
+        uses: pypa/gh-action-pypi-publish@release/v1

nb_nebi_kernels-0.1/.gitignore

@@ -0,0 +1,33 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+*.egg
+
+# Pixi
+.pixi/
+
+# IDE
+.vscode/
+.idea/
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+
+# Jupyter
+.ipynb_checkpoints/
+*.ipynb
+
+# Nested repos
+nebi/
+
+# OS
+.DS_Store
+# pixi environments
+.pixi/*
+!.pixi/config.toml

nb_nebi_kernels-0.1/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: nb-nebi-kernels
+Version: 0.1
+Summary: Jupyter KernelSpecManager that discovers kernels from nebi-tracked pixi workspaces
+Project-URL: Homepage, https://github.com/nebari-dev/nb-nebi-kernels
+Project-URL: Repository, https://github.com/nebari-dev/nb-nebi-kernels
+Author: OpenTeams
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Jupyter
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Requires-Dist: jupyter-client>=8.0.0
+Requires-Dist: jupyter-core>=5.0.0
+Requires-Dist: jupyter-server>=2.0.0
+Description-Content-Type: text/markdown
+
+# nb-nebi-kernels
+
+A custom Jupyter `KernelSpecManager` that automatically discovers [Nebi](https://github.com/nebari-dev/nebi)-tracked [Pixi](https://pixi.sh/) workspaces and exposes each environment as a launchable Jupyter kernel.
+
+## How it works
+
+1. Discovers locally-tracked workspaces via `nebi workspace list`
+2. Enumerates pixi environments per workspace via `pixi workspace environment list`
+3. Each (workspace, environment) pair appears as a selectable kernel in Jupyter
+4. Kernels launch via `pixi run` in the workspace directory with full environment isolation
+
+## Installation
+
+```bash
+pip install nb-nebi-kernels
+```
+
+That's it — the kernel spec manager is automatically configured when installed into your JupyterLab environment.
+
+### Prerequisites
+
+- [Nebi CLI](https://github.com/nebari-dev/nebi) on your PATH
+- [Pixi](https://pixi.sh/) on your PATH
+- At least one tracked nebi workspace (`nebi init` in a pixi project)
+
+## Usage
+
+Once installed, any nebi-tracked pixi workspace appears as a kernel in JupyterLab or Notebook:
+
+- A workspace `data-science` with environments `default` and `gpu` shows as two kernels: **data-science (default)** and **data-science (gpu)**
+- A workspace `web-app` with only the default environment shows as just **web-app**
+
+If nebi or pixi are not installed, or no workspaces are tracked, Jupyter falls back to its default kernels — it never crashes.
+
+## Development
+
+```bash
+# Install dev dependencies
+pixi install -e dev
+
+# Run tests
+pixi run test
+
+# Run tests with coverage
+pixi run test-cov
+
+# Run linting
+pixi run lint
+
+# Format code
+pixi run format
+
+# Run type checking
+pixi run typecheck
+```
+
+## Architecture
+
+```
+src/nb_nebi_kernels/
+├── __init__.py      # Exports NebiKernelSpecManager
+├── discovery.py     # Subprocess calls to nebi + pixi CLIs
+├── launcher.py      # Kernel launcher with pixi environment isolation
+└── manager.py       # KernelSpecManager subclass (core logic)
+```
+
+- **discovery.py** — Parses `nebi workspace list` output, calls `pixi workspace environment list` per workspace. Filters out missing workspaces. Returns structured data.
+- **launcher.py** — Clears PIXI_* environment variables to prevent inheriting parent context, then exec's `pixi run` in the workspace directory.
+- **manager.py** — Subclasses `KernelSpecManager`, implements `find_kernel_specs()` and `get_kernel_spec()`. Merges parent kernels with nebi-discovered ones.
+
+## License
+
+MIT

nb_nebi_kernels-0.1/README.md

@@ -0,0 +1,73 @@
+# nb-nebi-kernels
+
+A custom Jupyter `KernelSpecManager` that automatically discovers [Nebi](https://github.com/nebari-dev/nebi)-tracked [Pixi](https://pixi.sh/) workspaces and exposes each environment as a launchable Jupyter kernel.
+
+## How it works
+
+1. Discovers locally-tracked workspaces via `nebi workspace list`
+2. Enumerates pixi environments per workspace via `pixi workspace environment list`
+3. Each (workspace, environment) pair appears as a selectable kernel in Jupyter
+4. Kernels launch via `pixi run` in the workspace directory with full environment isolation
+
+## Installation
+
+```bash
+pip install nb-nebi-kernels
+```
+
+That's it — the kernel spec manager is automatically configured when installed into your JupyterLab environment.
+
+### Prerequisites
+
+- [Nebi CLI](https://github.com/nebari-dev/nebi) on your PATH
+- [Pixi](https://pixi.sh/) on your PATH
+- At least one tracked nebi workspace (`nebi init` in a pixi project)
+
+## Usage
+
+Once installed, any nebi-tracked pixi workspace appears as a kernel in JupyterLab or Notebook:
+
+- A workspace `data-science` with environments `default` and `gpu` shows as two kernels: **data-science (default)** and **data-science (gpu)**
+- A workspace `web-app` with only the default environment shows as just **web-app**
+
+If nebi or pixi are not installed, or no workspaces are tracked, Jupyter falls back to its default kernels — it never crashes.
+
+## Development
+
+```bash
+# Install dev dependencies
+pixi install -e dev
+
+# Run tests
+pixi run test
+
+# Run tests with coverage
+pixi run test-cov
+
+# Run linting
+pixi run lint
+
+# Format code
+pixi run format
+
+# Run type checking
+pixi run typecheck
+```
+
+## Architecture
+
+```
+src/nb_nebi_kernels/
+├── __init__.py      # Exports NebiKernelSpecManager
+├── discovery.py     # Subprocess calls to nebi + pixi CLIs
+├── launcher.py      # Kernel launcher with pixi environment isolation
+└── manager.py       # KernelSpecManager subclass (core logic)
+```
+
+- **discovery.py** — Parses `nebi workspace list` output, calls `pixi workspace environment list` per workspace. Filters out missing workspaces. Returns structured data.
+- **launcher.py** — Clears PIXI_* environment variables to prevent inheriting parent context, then exec's `pixi run` in the workspace directory.
+- **manager.py** — Subclasses `KernelSpecManager`, implements `find_kernel_specs()` and `get_kernel_spec()`. Merges parent kernels with nebi-discovered ones.
+
+## License
+
+MIT