matplotly 0.1.0__tar.gz

matplotly-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,44 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build package
+        run: |
+          pip install build
+          python -m build
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

matplotly-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,28 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run tests
+        run: python -m pytest tests/ -v

matplotly-0.1.0/.gitignore

@@ -0,0 +1,28 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+*.egg
+
+# Virtual environment
+.venv/
+
+# Jupyter
+.ipynb_checkpoints/
+
+# Exported figures
+*.pdf
+*.png
+*.svg
+*.jpg
+
+# OS
+.DS_Store
+
+# Docs
+docs/_build/
+
+# Tools
+.ruff_cache/

matplotly-0.1.0/.readthedocs.yaml

@@ -0,0 +1,16 @@
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
+
+sphinx:
+  configuration: docs/conf.py
+
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs

matplotly-0.1.0/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## [0.1.0] — 2025-06-01
+
+### Added
+
+- Initial release of matplotly
+- Jupyter-native interactive matplotlib figure editor
+- Support for 10+ plot types: line, scatter, bar, histogram, box, violin, errorbar, heatmap, fill, marginal
+- Three usage modes: direct figure, decorator, context manager
+- Code generation for reproducible figures
+- Undo / redo with full command history
+- Style profiles: save and load reusable figure styles
+- Subplot support with per-axes controls

matplotly-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Peter Koo
+
+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.

matplotly-0.1.0/PKG-INFO

@@ -0,0 +1,120 @@
+Metadata-Version: 2.4
+Name: matplotly
+Version: 0.1.0
+Summary: Jupyter-native interactive matplotlib figure editor
+Project-URL: Homepage, https://github.com/p-koo/matplotly
+Project-URL: Documentation, https://matplotly.readthedocs.io
+Project-URL: Bug Tracker, https://github.com/p-koo/matplotly/issues
+Author: Peter Koo
+License-Expression: MIT
+License-File: LICENSE
+Keywords: interactive,jupyter,matplotlib,plotting,widgets
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Jupyter
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.9
+Requires-Dist: ipympl>=0.9.0
+Requires-Dist: ipywidgets>=8.0.0
+Requires-Dist: matplotlib>=3.8.0
+Requires-Dist: numpy>=1.24.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: myst-parser>=3.0; extra == 'docs'
+Requires-Dist: nbsphinx>=0.9; extra == 'docs'
+Requires-Dist: sphinx-rtd-theme>=2.0; extra == 'docs'
+Requires-Dist: sphinx>=7.0; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# matplotly
+
+[![PyPI version](https://img.shields.io/pypi/v/matplotly.svg)](https://pypi.org/project/matplotly/)
+[![Python versions](https://img.shields.io/pypi/pyversions/matplotly.svg)](https://pypi.org/project/matplotly/)
+[![License](https://img.shields.io/pypi/l/matplotly.svg)](https://github.com/p-koo/matplotly/blob/main/LICENSE)
+[![Docs](https://readthedocs.org/projects/matplotly/badge/?version=latest)](https://matplotly.readthedocs.io)
+
+**Jupyter-native interactive matplotlib figure editor.**
+
+Edit any matplotlib figure interactively — styles, colors, labels, legends — then export
+reproducible Python code. No separate GUI; everything runs inline in your notebook.
+
+## Features
+
+- **10+ plot types**: line, scatter, bar, histogram, box, violin, errorbar, heatmap, fill, marginal
+- **Code generation**: export a standalone Python script that recreates your styled figure
+- **Undo / redo**: full command history with keyboard shortcuts
+- **Style profiles**: save and load reusable figure styles
+- **Subplot support**: edit multi-panel figures with per-axes controls
+
+## Installation
+
+```bash
+pip install matplotly
+```
+
+Requires a Jupyter environment with the `ipympl` backend enabled:
+
+```python
+%matplotlib widget
+```
+
+## Quick Start
+
+```python
+%matplotlib widget
+import matplotlib.pyplot as plt
+from matplotly import matplotly
+
+# 1. Pass a figure directly
+fig, ax = plt.subplots()
+ax.plot([1, 2, 3], [1, 4, 9])
+matplotly(fig)
+
+# 2. Decorator mode
+@matplotly
+def my_plot():
+    plt.plot([1, 2, 3], [1, 4, 9])
+
+my_plot()
+
+# 3. Context manager
+with matplotly() as pb:
+    fig, ax = plt.subplots()
+    ax.plot([1, 2, 3], [1, 4, 9])
+```
+
+## Supported Plot Types
+
+| Type | Description |
+|------|-------------|
+| Line | `ax.plot()` |
+| Scatter | `ax.scatter()` |
+| Bar | `ax.bar()` / `ax.barh()` |
+| Histogram | `ax.hist()` |
+| Box | `ax.boxplot()` |
+| Violin | `ax.violinplot()` |
+| Errorbar | `ax.errorbar()` |
+| Heatmap | `ax.imshow()` / `ax.pcolormesh()` |
+| Fill | `ax.fill_between()` / `ax.fill_betweenx()` |
+| Marginal | Joint + marginal distribution plots |
+
+## Documentation
+
+Full documentation is available at [matplotly.readthedocs.io](https://matplotly.readthedocs.io).
+
+## Contributing
+
+Contributions are welcome! Please open an issue or pull request on
+[GitHub](https://github.com/p-koo/matplotly).
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.

matplotly-0.1.0/README.md

@@ -0,0 +1,84 @@
+# matplotly
+
+[![PyPI version](https://img.shields.io/pypi/v/matplotly.svg)](https://pypi.org/project/matplotly/)
+[![Python versions](https://img.shields.io/pypi/pyversions/matplotly.svg)](https://pypi.org/project/matplotly/)
+[![License](https://img.shields.io/pypi/l/matplotly.svg)](https://github.com/p-koo/matplotly/blob/main/LICENSE)
+[![Docs](https://readthedocs.org/projects/matplotly/badge/?version=latest)](https://matplotly.readthedocs.io)
+
+**Jupyter-native interactive matplotlib figure editor.**
+
+Edit any matplotlib figure interactively — styles, colors, labels, legends — then export
+reproducible Python code. No separate GUI; everything runs inline in your notebook.
+
+## Features
+
+- **10+ plot types**: line, scatter, bar, histogram, box, violin, errorbar, heatmap, fill, marginal
+- **Code generation**: export a standalone Python script that recreates your styled figure
+- **Undo / redo**: full command history with keyboard shortcuts
+- **Style profiles**: save and load reusable figure styles
+- **Subplot support**: edit multi-panel figures with per-axes controls
+
+## Installation
+
+```bash
+pip install matplotly
+```
+
+Requires a Jupyter environment with the `ipympl` backend enabled:
+
+```python
+%matplotlib widget
+```
+
+## Quick Start
+
+```python
+%matplotlib widget
+import matplotlib.pyplot as plt
+from matplotly import matplotly
+
+# 1. Pass a figure directly
+fig, ax = plt.subplots()
+ax.plot([1, 2, 3], [1, 4, 9])
+matplotly(fig)
+
+# 2. Decorator mode
+@matplotly
+def my_plot():
+    plt.plot([1, 2, 3], [1, 4, 9])
+
+my_plot()
+
+# 3. Context manager
+with matplotly() as pb:
+    fig, ax = plt.subplots()
+    ax.plot([1, 2, 3], [1, 4, 9])
+```
+
+## Supported Plot Types
+
+| Type | Description |
+|------|-------------|
+| Line | `ax.plot()` |
+| Scatter | `ax.scatter()` |
+| Bar | `ax.bar()` / `ax.barh()` |
+| Histogram | `ax.hist()` |
+| Box | `ax.boxplot()` |
+| Violin | `ax.violinplot()` |
+| Errorbar | `ax.errorbar()` |
+| Heatmap | `ax.imshow()` / `ax.pcolormesh()` |
+| Fill | `ax.fill_between()` / `ax.fill_betweenx()` |
+| Marginal | Joint + marginal distribution plots |
+
+## Documentation
+
+Full documentation is available at [matplotly.readthedocs.io](https://matplotly.readthedocs.io).
+
+## Contributing
+
+Contributions are welcome! Please open an issue or pull request on
+[GitHub](https://github.com/p-koo/matplotly).
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.