variable-explorer 0.7.0__tar.gz

variable_explorer-0.7.0/.claude/settings.local.json

@@ -0,0 +1,41 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(pip show:*)",
+      "Bash(npm --version)",
+      "Bash(pip list:*)",
+      "Bash(python:*)",
+      "Bash(xargs ls:*)",
+      "Bash(jupyter labextension:*)",
+      "Bash(node -e \"console.log\\(require.resolve\\('@jupyterlab/services'\\)\\)\")",
+      "Bash(npm view:*)",
+      "Bash(npm list:*)",
+      "Bash(npm pack:*)",
+      "WebFetch(domain:raw.githubusercontent.com)",
+      "Bash(pip install:*)",
+      "Bash(jlpm install:*)",
+      "Bash(jlpm build:lib)",
+      "Bash(node -e \"const s = require\\('@jupyterlab/services'\\); console.log\\(Object.keys\\(s\\).filter\\(k => k.includes\\('Kernel'\\)\\).join\\(', '\\)\\)\")",
+      "Bash(jlpm build:labextension:dev)",
+      "Bash(mkdir -p Projects/ve_build)",
+      "Bash(cp -r \"Z:/Consulting/Projects/variable_explorer/\"* \"C:/Users/Owner/Projects/ve_build/\")",
+      "Bash(cp \"Z:/Consulting/Projects/variable_explorer/.yarnrc.yml\" \"C:/Users/Owner/Projects/ve_build/\")",
+      "Bash(cmd.exe:*)",
+      "Bash(node \"node_modules/@jupyterlab/builder/lib/build-labextension.js\" --core-path \"C:/Users/Owner/anaconda3/Lib/site-packages/jupyterlab/staging\" \".\" --development)",
+      "Bash(twine upload:*)",
+      "Bash(gh auth:*)",
+      "Bash(gh org:*)",
+      "Bash(gh repo:*)",
+      "Bash(jlpm build *)",
+      "Bash(where node *)",
+      "Bash(where npm *)",
+      "Bash(where jlpm *)",
+      "PowerShell(Get-Command *)",
+      "PowerShell(jlpm build *)",
+      "PowerShell(jlpm build:lib *)",
+      "PowerShell(jupyter labextension *)",
+      "PowerShell(Test-Path *)",
+      "Bash(curl -s \"https://pypi.org/pypi/variable-explorer/json\")"
+    ]
+  }
+}

variable_explorer-0.7.0/.gitignore

@@ -0,0 +1,11 @@
+node_modules/
+lib/
+*.egg-info/
+dist/
+build/
+.yarn/
+*.tgz
+*.tsbuildinfo
+__pycache__/
+*.pyc
+.ipynb_checkpoints/

variable_explorer-0.7.0/.yarnrc.yml

@@ -0,0 +1 @@
+nodeLinker: node-modules

variable_explorer-0.7.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Variable Explorer Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

variable_explorer-0.7.0/MANIFEST.in

@@ -0,0 +1,15 @@
+include LICENSE
+include README.md
+include install.json
+include package.json
+include tsconfig.json
+include .yarnrc.yml
+
+graft variable_explorer/labextension
+graft src
+graft style
+graft schema
+
+prune node_modules
+prune .yarn
+prune lib

variable_explorer-0.7.0/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: variable-explorer
+Version: 0.7.0
+Summary: A Spyder/Stata-grade variable explorer for JupyterLab
+Project-URL: Homepage, https://github.com/variable-explorer/variable-explorer
+License: MIT
+License-File: LICENSE
+Classifier: Framework :: Jupyter
+Classifier: Framework :: Jupyter :: JupyterLab
+Classifier: Framework :: Jupyter :: JupyterLab :: 4
+Classifier: Framework :: Jupyter :: JupyterLab :: Extensions
+Classifier: Framework :: Jupyter :: JupyterLab :: Extensions :: Prebuilt
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Requires-Dist: jupyterlab<5,>=4.0.0
+Requires-Dist: numpy
+Requires-Dist: pandas
+Provides-Extra: sql
+Requires-Dist: duckdb>=0.9; extra == 'sql'
+Description-Content-Type: text/markdown
+
+# Variable Explorer for JupyterLab
+
+A Spyder/Stata-grade variable explorer for JupyterLab 4. Opens in its own window so you can put it on a second monitor.
+
+## Install
+
+```bash
+pip install variable-explorer
+```
+
+That's it. Restart JupyterLab if it's running.
+
+## Usage
+
+1. Open a notebook in JupyterLab
+2. Click the **Variables** button in the notebook toolbar (spreadsheet icon)
+3. The Variable Explorer opens in a **separate browser window**
+4. Run cells — the variable list updates automatically
+5. Click any DataFrame, list, or dict to view its contents
+
+## Features
+
+- **Detached window** — lives outside JupyterLab, move it to another monitor
+- **AG Grid** — fast virtual scrolling, handles large DataFrames
+- **Column sorting** — click headers to sort (kernel-side, fast even on millions of rows)
+- **Inline histograms** — distribution charts in every column header with hover tooltips
+- **Conditional formatting** — numeric heatmaps, boolean color-coding
+- **Metadata sidebar** — column types, null counts, stats (like Stata's Variable Manager)
+- **Properties panel** — dataset shape, memory usage, dtypes
+- **Cell editing** — double-click to edit values, synced back to the kernel
+- **Resizable panels** — drag the dividers between panels
+- **Auto-refresh** — variable list updates after every cell execution
+- **Supports many types** — DataFrames, Series, numpy arrays, lists of dicts, dicts of lists, nested structures
+
+## Requirements
+
+- JupyterLab 4.x
+- Python 3.10+
+- pandas (for DataFrame viewing)
+
+## Development
+
+```bash
+# Clone and install in development mode
+git clone https://github.com/variable-explorer/variable-explorer.git
+cd variable-explorer
+pip install -e .
+
+# Rebuild after making changes
+jlpm install
+jlpm build
+pip install -e .
+```
+
+Requires Node.js 18+ for development builds.

variable_explorer-0.7.0/README.md

@@ -0,0 +1,55 @@
+# Variable Explorer for JupyterLab
+
+A Spyder/Stata-grade variable explorer for JupyterLab 4. Opens in its own window so you can put it on a second monitor.
+
+## Install
+
+```bash
+pip install variable-explorer
+```
+
+That's it. Restart JupyterLab if it's running.
+
+## Usage
+
+1. Open a notebook in JupyterLab
+2. Click the **Variables** button in the notebook toolbar (spreadsheet icon)
+3. The Variable Explorer opens in a **separate browser window**
+4. Run cells — the variable list updates automatically
+5. Click any DataFrame, list, or dict to view its contents
+
+## Features
+
+- **Detached window** — lives outside JupyterLab, move it to another monitor
+- **AG Grid** — fast virtual scrolling, handles large DataFrames
+- **Column sorting** — click headers to sort (kernel-side, fast even on millions of rows)
+- **Inline histograms** — distribution charts in every column header with hover tooltips
+- **Conditional formatting** — numeric heatmaps, boolean color-coding
+- **Metadata sidebar** — column types, null counts, stats (like Stata's Variable Manager)
+- **Properties panel** — dataset shape, memory usage, dtypes
+- **Cell editing** — double-click to edit values, synced back to the kernel
+- **Resizable panels** — drag the dividers between panels
+- **Auto-refresh** — variable list updates after every cell execution
+- **Supports many types** — DataFrames, Series, numpy arrays, lists of dicts, dicts of lists, nested structures
+
+## Requirements
+
+- JupyterLab 4.x
+- Python 3.10+
+- pandas (for DataFrame viewing)
+
+## Development
+
+```bash
+# Clone and install in development mode
+git clone https://github.com/variable-explorer/variable-explorer.git
+cd variable-explorer
+pip install -e .
+
+# Rebuild after making changes
+jlpm install
+jlpm build
+pip install -e .
+```
+
+Requires Node.js 18+ for development builds.

variable_explorer-0.7.0/fix_frontend.py

@@ -0,0 +1,52 @@
+content = open('src/components/VariableExplorerApp.tsx').read()
+
+# 1. Add error state after loading state
+content = content.replace(
+    'const [loading, setLoading] = React.useState(false);',
+    'const [loading, setLoading] = React.useState(false);\n  const [error, setError] = React.useState<string | null>(null);'
+)
+
+# 2. Clear error when fetching data
+content = content.replace(
+    'setRows([]);\n    setSortModel([]);\n    setCellSelection(null);',
+    'setError(null);\n    setRows([]);\n    setSortModel([]);\n    setCellSelection(null);'
+)
+
+# 3. Update error handler to show in UI
+old_error = """        case 'error':
+          console.error('Variable Explorer kernel error:', msg.message);
+          setLoading(false);
+          break;"""
+new_error = """        case 'error':
+          console.error('Variable Explorer kernel error:', msg.message);
+          setError(msg.message || 'Unknown error');
+          setLoading(false);
+          break;"""
+content = content.replace(old_error, new_error)
+
+# 4. Update empty state to show error
+old_empty = """            ) : (
+              <div className="ve-empty-state">
+                {loading ? (
+                  <div className="ve-loading">
+                    <div className="ve-spinner" />
+                  </div>
+                ) : !connected ? ("""
+
+new_empty = """            ) : (
+              <div className="ve-empty-state">
+                {error ? (
+                  <>
+                    <div className="ve-empty-icon" style={{ color: 'var(--jp-error-color1)' }}>&#x26a0;</div>
+                    <div style={{ color: 'var(--jp-error-color1)' }}>{error}</div>
+                  </>
+                ) : loading ? (
+                  <div className="ve-loading">
+                    <div className="ve-spinner" />
+                  </div>
+                ) : !connected ? ("""
+
+content = content.replace(old_empty, new_empty)
+
+open('src/components/VariableExplorerApp.tsx', 'w').write(content)
+print('Done')

variable_explorer-0.7.0/install.json

@@ -0,0 +1,5 @@
+{
+  "packageManager": "python",
+  "packageName": "variable_explorer",
+  "uninstallInstructions": "pip uninstall variable_explorer"
+}

variable_explorer-0.7.0/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "variable-explorer",
+  "version": "0.7.0",
+  "description": "A Spyder/Stata-grade variable explorer for JupyterLab",
+  "keywords": [
+    "jupyter",
+    "jupyterlab",
+    "jupyterlab-extension",
+    "variable-explorer",
+    "dataframe-viewer"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Variable Explorer Contributors"
+  },
+  "files": [
+    "lib/**/*.{d.ts,eot,gif,html,jpg,js,js.map,json,png,svg,woff2,ttf}",
+    "style/**/*.{css,js,eot,gif,html,jpg,json,png,svg,woff2,ttf}"
+  ],
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "style": "style/index.css",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "scripts": {
+    "build": "jlpm build:lib && jlpm build:labextension:dev",
+    "build:prod": "jlpm clean && jlpm build:lib && jlpm build:labextension",
+    "build:labextension": "jupyter labextension build .",
+    "build:labextension:dev": "jupyter labextension build --development True .",
+    "build:lib": "tsc",
+    "clean": "jlpm clean:lib && jlpm clean:labextension",
+    "clean:lib": "rimraf lib tsconfig.tsbuildinfo",
+    "clean:labextension": "rimraf variable_explorer/labextension",
+    "install:extension": "jlpm build",
+    "watch": "run-p watch:src watch:labextension",
+    "watch:src": "tsc -w --sourceMap",
+    "watch:labextension": "jupyter labextension watch ."
+  },
+  "dependencies": {
+    "@jupyterlab/application": "^4.0.0",
+    "@jupyterlab/apputils": "^4.0.0",
+    "@jupyterlab/console": "^4.0.0",
+    "@jupyterlab/notebook": "^4.0.0",
+    "@jupyterlab/services": "^7.0.0",
+    "@jupyterlab/statusbar": "^4.0.0",
+    "@jupyterlab/ui-components": "^4.0.0",
+    "@lumino/coreutils": "^2.0.0",
+    "@lumino/disposable": "^2.0.0",
+    "@lumino/messaging": "^2.0.0",
+    "@lumino/signaling": "^2.0.0",
+    "@lumino/widgets": "^2.0.0",
+    "ag-grid-community": "^32.0.0",
+    "ag-grid-react": "^32.0.0"
+  },
+  "devDependencies": {
+    "@jupyterlab/builder": "^4.0.0",
+    "@types/react": "^18.0.26",
+    "@types/react-dom": "^18.0.9",
+    "css-loader": "^6.7.1",
+    "npm-run-all2": "^7.0.1",
+    "rimraf": "^5.0.1",
+    "source-map-loader": "^1.0.2",
+    "style-loader": "^3.3.1",
+    "typescript": "~5.5.0"
+  },
+  "sideEffects": [
+    "style/*.css",
+    "style/index.js"
+  ],
+  "styleModule": "style/index.js",
+  "publishConfig": {
+    "access": "public"
+  },
+  "jupyterlab": {
+    "extension": true,
+    "outputDir": "variable_explorer/labextension",
+    "schemaDir": "schema",
+    "sharedPackages": {
+      "ag-grid-community": {
+        "bundled": true,
+        "singleton": true
+      },
+      "ag-grid-react": {
+        "bundled": true,
+        "singleton": true
+      }
+    }
+  }
+}

variable_explorer-0.7.0/pyproject.toml

@@ -0,0 +1,71 @@
+[build-system]
+requires = ["hatchling>=1.5.0", "jupyterlab>=4.0.0,<5", "hatch-nodejs-version>=0.3.2"]
+build-backend = "hatchling.build"
+
+[project]
+name = "variable-explorer"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+classifiers = [
+    "Framework :: Jupyter",
+    "Framework :: Jupyter :: JupyterLab",
+    "Framework :: Jupyter :: JupyterLab :: 4",
+    "Framework :: Jupyter :: JupyterLab :: Extensions",
+    "Framework :: Jupyter :: JupyterLab :: Extensions :: Prebuilt",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "jupyterlab>=4.0.0,<5",
+    "pandas",
+    "numpy",
+]
+dynamic = ["version", "description"]
+
+[project.optional-dependencies]
+sql = ["duckdb>=0.9"]
+
+[project.urls]
+Homepage = "https://github.com/variable-explorer/variable-explorer"
+
+[tool.hatch.version]
+source = "nodejs"
+
+[tool.hatch.metadata.hooks.nodejs]
+fields = ["description", "version"]
+
+[tool.hatch.build.targets.sdist]
+artifacts = ["variable_explorer/labextension"]
+exclude = [".github", "binder", "node_modules", ".yarn", "*.tgz"]
+
+[tool.hatch.build.targets.wheel.shared-data]
+"variable_explorer/labextension" = "share/jupyter/labextensions/variable-explorer"
+"install.json" = "share/jupyter/labextensions/variable-explorer/install.json"
+
+[tool.hatch.build.hooks.version]
+path = "variable_explorer/_version.py"
+
+[tool.hatch.build.hooks.jupyter-builder]
+dependencies = ["hatch-jupyter-builder>=0.5"]
+build-function = "hatch_jupyter_builder.npm_builder"
+ensured-targets = [
+    "variable_explorer/labextension/static/style.js",
+    "variable_explorer/labextension/package.json",
+]
+skip-if-exists = ["variable_explorer/labextension/static/style.js"]
+
+[tool.hatch.build.hooks.jupyter-builder.build-kwargs]
+build_cmd = "build:prod"
+npm = ["jlpm"]
+
+[tool.hatch.build.hooks.jupyter-builder.editable-build-kwargs]
+build_cmd = "install:extension"
+npm = ["jlpm"]
+source_dir = "src"
+build_dir = "variable_explorer/labextension"

variable_explorer-0.7.0/schema/plugin.json

@@ -0,0 +1,75 @@
+{
+  "jupyter.lab.setting-icon-label": "Variable Explorer",
+  "title": "Variable Explorer",
+  "description": "Variable Explorer settings.",
+  "jupyter.lab.toolbars": {
+    "Notebook": [
+      {
+        "name": "variable-explorer-open",
+        "command": "variable-explorer:open",
+        "rank": 50,
+        "label": "Variables"
+      }
+    ]
+  },
+  "jupyter.lab.menus": {
+    "main": [
+      {
+        "id": "jp-mainmenu-view",
+        "items": [
+          {
+            "command": "variable-explorer:open",
+            "rank": 1
+          }
+        ]
+      }
+    ]
+  },
+  "type": "object",
+  "properties": {
+    "toolbar": {
+      "title": "Notebook toolbar items",
+      "description": "Toolbar items for notebooks",
+      "items": {
+        "$ref": "#/definitions/toolbarItem"
+      },
+      "type": "array",
+      "default": []
+    },
+    "pageSize": {
+      "type": "number",
+      "title": "Page Size",
+      "description": "Number of rows to load per page in the data grid.",
+      "default": 1000
+    },
+    "maxHistogramBins": {
+      "type": "number",
+      "title": "Max Histogram Bins",
+      "description": "Maximum number of bins for column histograms.",
+      "default": 20
+    },
+    "enableConditionalFormatting": {
+      "type": "boolean",
+      "title": "Enable Conditional Formatting",
+      "description": "Enable heatmap coloring for numeric columns.",
+      "default": true
+    }
+  },
+  "additionalProperties": false,
+  "definitions": {
+    "toolbarItem": {
+      "properties": {
+        "name": { "type": "string" },
+        "args": { "type": "object" },
+        "command": { "type": "string", "default": "" },
+        "disabled": { "type": "boolean", "default": false },
+        "icon": { "type": "string", "default": "" },
+        "label": { "type": "string", "default": "" },
+        "type": { "type": "string", "enum": ["command", "spacer"], "default": "command" },
+        "rank": { "type": "number", "default": 50 }
+      },
+      "additionalProperties": false,
+      "type": "object"
+    }
+  }
+}

variable_explorer-0.7.0/src/comm/CommManager.ts

@@ -0,0 +1,121 @@
+import { KernelMessage as JupyterKernelMessage, Kernel } from '@jupyterlab/services';
+import { Signal, ISignal } from '@lumino/signaling';
+import { FrontendMessage, ICommMessage } from './protocol';
+
+const COMM_TARGET = 'variable_explorer';
+
+const INIT_CODE = `
+try:
+    from variable_explorer.kernel import init_comm as _ve_init
+    _ve_init()
+    del _ve_init
+except ImportError as e:
+    print(f"Variable Explorer: kernel package not found: {e}")
+except Exception as e:
+    print(f"Variable Explorer: init error: {e}")
+`.trim();
+
+export class CommManager {
+  private _comm: any = null;
+  private _kernel: Kernel.IKernelConnection | null = null;
+  private _messageReceived = new Signal<CommManager, ICommMessage>(this);
+  private _connectionChanged = new Signal<CommManager, boolean>(this);
+  private _isConnected = false;
+
+  get messageReceived(): ISignal<CommManager, ICommMessage> {
+    return this._messageReceived;
+  }
+
+  get connectionChanged(): ISignal<CommManager, boolean> {
+    return this._connectionChanged;
+  }
+
+  get isConnected(): boolean {
+    return this._isConnected;
+  }
+
+  async connect(kernel: Kernel.IKernelConnection): Promise<void> {
+    // Disconnect existing
+    this.disconnect();
+    this._kernel = kernel;
+
+    // Inject the Python init code
+    const future = kernel.requestExecute({
+      code: INIT_CODE,
+      silent: true,
+      store_history: false
+    });
+    await future.done;
+
+    // Open a comm from the frontend
+    this._comm = kernel.createComm(COMM_TARGET);
+
+    // Handle incoming messages
+    this._comm.onMsg = (msg: JupyterKernelMessage.ICommMsgMsg) => {
+      const data = msg.content.data as unknown as ICommMessage;
+      if (data && data.type) {
+        this._messageReceived.emit(data);
+      }
+    };
+
+    this._comm.onClose = () => {
+      this._setConnected(false);
+    };
+
+    // Open the comm channel
+    await this._comm.open({}).done;
+    this._setConnected(true);
+
+    // Listen for kernel shutdown/restart
+    kernel.statusChanged.connect(this._onKernelStatus, this);
+  }
+
+  send(msg: FrontendMessage): void {
+    if (this._comm && this._isConnected) {
+      this._comm.send(msg as any);
+    }
+  }
+
+  refresh(): void {
+    this.send({ type: 'refresh' });
+  }
+
+  disconnect(): void {
+    if (this._kernel) {
+      this._kernel.statusChanged.disconnect(this._onKernelStatus, this);
+    }
+    if (this._comm) {
+      try {
+        this._comm.close({});
+      } catch {
+        // Comm may already be closed
+      }
+      this._comm = null;
+    }
+    this._kernel = null;
+    this._setConnected(false);
+  }
+
+  private _setConnected(connected: boolean): void {
+    if (this._isConnected !== connected) {
+      this._isConnected = connected;
+      this._connectionChanged.emit(connected);
+    }
+  }
+
+  private _onKernelStatus(
+    kernel: Kernel.IKernelConnection,
+    status: JupyterKernelMessage.Status
+  ): void {
+    if (status === 'restarting' || status === 'dead') {
+      this._setConnected(false);
+      this._comm = null;
+    }
+    if (status === 'idle' && !this._isConnected && this._kernel) {
+      // Kernel restarted — try to reconnect
+      this.connect(this._kernel).catch(e => {
+        console.error('Variable Explorer: reconnect failed', e);
+      });
+    }
+  }
+}