figrecipe 0.9.0__tar.gz

figrecipe-0.9.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,52 @@
+---
+name: Bug Report
+about: Report a bug to help us improve FigRecipe
+title: "[BUG] "
+labels: bug
+assignees: ''
+---
+
+## Description
+
+A clear and concise description of the bug.
+
+## To Reproduce
+
+Steps to reproduce the behavior:
+
+1. ...
+2. ...
+3. ...
+
+## Minimal Code Example
+
+```python
+import figrecipe as fr
+
+# Minimal code that reproduces the issue
+```
+
+## Expected Behavior
+
+What you expected to happen.
+
+## Actual Behavior
+
+What actually happened.
+
+## Error Traceback
+
+```
+Paste full error traceback here (if applicable)
+```
+
+## Environment
+
+- OS: [e.g., Ubuntu 22.04, Windows 11, macOS 14]
+- Python version: [e.g., 3.11.5]
+- FigRecipe version: [run `pip show figrecipe`]
+- Matplotlib version: [run `pip show matplotlib`]
+
+## Additional Context
+
+Add any other context, screenshots, or generated files here.

figrecipe-0.9.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Documentation
+    url: https://github.com/ywatanabe1989/figrecipe#readme
+    about: Check the README for usage examples and API reference

figrecipe-0.9.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,33 @@
+---
+name: Feature Request
+about: Suggest a new feature for FigRecipe
+title: "[FEATURE] "
+labels: enhancement
+assignees: ''
+---
+
+## Problem Statement
+
+A clear description of the problem you're trying to solve.
+
+Example: "I'm frustrated when trying to..."
+
+## Proposed Solution
+
+A clear description of what you'd like to happen.
+
+## Example Usage
+
+```python
+import figrecipe as fr
+
+# How you envision using this feature
+```
+
+## Alternatives Considered
+
+Any alternative solutions or features you've considered.
+
+## Additional Context
+
+Add any other context, mockups, or references here.

figrecipe-0.9.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,34 @@
+## Summary
+
+Brief description of the changes.
+
+## Type of Change
+
+- [ ] Bug fix (non-breaking change that fixes an issue)
+- [ ] New feature (non-breaking change that adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to change)
+- [ ] Documentation update
+- [ ] Refactoring (no functional changes)
+
+## Related Issues
+
+Fixes #(issue number)
+
+## Changes Made
+
+-
+-
+-
+
+## Testing
+
+- [ ] Tests pass locally (`make test`)
+- [ ] Linter passes (`make lint`)
+- [ ] New tests added (if applicable)
+
+## Checklist
+
+- [ ] My code follows the project's code style
+- [ ] I have updated the documentation (if needed)
+- [ ] I have added tests that prove my fix/feature works
+- [ ] All new and existing tests pass

figrecipe-0.9.0/.github/workflows/test.yml

@@ -0,0 +1,60 @@
+name: Tests
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+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 system fonts (Arial, etc.)
+        run: |
+          echo ttf-mscorefonts-installer msttcorefonts/accepted-mscorefonts-eula select true | sudo debconf-set-selections
+          sudo apt-get update
+          sudo apt-get install -y ttf-mscorefonts-installer fontconfig
+          sudo fc-cache -f -v
+          # Clear matplotlib font cache
+          rm -rf ~/.cache/matplotlib
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[all]"
+
+      - name: Install Playwright browsers
+        run: |
+          playwright install chromium
+
+      - name: Run tests
+        run: |
+          pytest tests/ -v --tb=short --ignore=tests/editor
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install ruff
+        run: pip install ruff
+
+      - name: Run ruff
+        run: ruff check src/

figrecipe-0.9.0/.gitignore

@@ -0,0 +1,121 @@
+# Claude Code
+CLAUDE.md
+.claude
+docs/to_claude
+REFACTORING.md
+project_management/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+outputs/
+!outputs/notebook/
+*.png
+!docs/figrecipe_logo.png
+!docs/images/*.png
+!docs/images/**/*.png
+!outputs/notebook/*.png
+*.yaml
+!.pre-commit-config.yaml
+!pyproject.toml
+!outputs/notebook/*.yaml
+!src/figrecipe/styles/presets/*.yaml
+*.npy
+*.npz
+*.csv
+GITIGNORED/
+examples/.ipynb_checkpoints/
+examples/.old/
+tts_cache/
+
+# BGM files (large files excluded, except smile.mp3 for demo)
+docs/bgm/*.mp3
+!docs/bgm/smile.mp3
+
+# Claude worktree symlinks
+.worktree-*
+
+# Claude worktree symlink
+/feature-demo-movie
+/.claude-worktree-symlinks
+# Claude worktree symlink
+/feature-cli
+# Claude worktree symlink
+/feature-datatable-direct-edit
+
+# Example outputs (generated files)
+examples/*/outputs_*/
+# Claude worktree symlink
+/feature-object-support
+# Claude worktree symlink
+/feature-editor-improvements

figrecipe-0.9.0/.old/README_v02.md

@@ -0,0 +1,288 @@
+<!-- ---
+!-- Timestamp: 2025-12-22 13:01:11
+!-- Author: ywatanabe
+!-- File: /home/ywatanabe/proj/figrecipe/README.md
+!-- --- -->
+
+<p align="center">
+  <img src="docs/figrecipe_logo.png" alt="figrecipe logo" width="200"/>
+</p>
+
+# FigRecipe
+
+**Reproducible matplotlib figures with mm-precision layouts.**
+FigRecipe is a lightweight recording & reproduction layer for matplotlib,
+designed for scientific figures that must remain **editable, inspectable,
+and reproducible**.
+
+Part of **SciTeX™ – Research OS for reproducible science**
+https://scitex.ai
+
+[![PyPI version](https://badge.fury.io/py/figrecipe.svg)](https://badge.fury.io/py/figrecipe)
+[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
+
+---
+
+## Why FigRecipe?
+
+In scientific workflows, figures are often:
+- hard to reproduce once scripts change,
+- resized manually in pixels or inches,
+- impossible to partially reuse or inspect later.
+
+**FigRecipe solves this by recording plotting calls as a structured “recipe”**,
+allowing figures to be:
+- faithfully reproduced,
+- partially re-rendered,
+- inspected for underlying data,
+- laid out in **exact millimeters** for publication.
+
+---
+
+## Key Features
+
+- ✅ Drop-in replacement for `matplotlib.pyplot`
+- ✅ Automatic recording of plotting calls
+- ✅ Reproduce figures from a YAML recipe
+- ✅ Extract plotted data programmatically
+- ✅ Selective reproduction of specific plots
+- ✅ Millimeter-based layout (journal-ready)
+- ✅ Publication-quality style presets
+- ✅ Dark theme support (data colors preserved)
+- ✅ Seamless seaborn integration
+- ✅ Crop figures to content with mm margins
+
+---
+
+## Installation
+
+```bash
+pip install figrecipe
+
+# Optional: for PDF export from notebooks (SVG → PDF)
+sudo apt install inkscape  # Linux
+brew install inkscape      # macOS
+
+```
+
+## Basic Usage
+
+### Recording & Saving
+
+``` python
+import figrecipe as fr
+import numpy as np
+
+x = np.linspace(0, 10, 100)
+y = np.sin(x)
+
+fig, ax = fr.subplots()
+ax.plot(x, y, color='red', linewidth=2, id='sine_wave')
+ax.set_xlabel('Time (s)')
+ax.set_ylabel('Amplitude')
+
+# Save image + recipe
+img_path, yaml_path, result = fr.save(fig, 'figure.png')
+# → creates: figure.png + figure.yaml
+```
+
+### Reproducing a Figure
+
+``` python
+import figrecipe as fr
+
+fig, ax = fr.reproduce('figure.yaml')
+```
+
+### Extracting Plotted Data
+
+``` python
+import figrecipe as fr
+
+data = fr.extract_data('figure.yaml')
+# {'sine_wave': {'x': array([...]), 'y': array([...])}}
+```
+
+### Millimeter-Based Layout (Publication-Ready)
+
+``` python
+fig, ax = fr.subplots(
+    axes_width_mm=60,
+    axes_height_mm=40,
+    margin_left_mm=15,
+    margin_bottom_mm=12,
+)
+```
+This guarantees consistent sizing across editors, exports, and journals.
+
+### Style Presets
+
+``` python
+fr.list_presets()
+# ['MATPLOTLIB', 'SCITEX']
+
+# Publication-quality preset (applied globally)
+fr.load_style('SCITEX')
+fig, ax = fr.subplots()
+
+# Dark theme (UI-only, data colors preserved)
+fr.load_style('SCITEX_DARK')
+# or: fr.load_style('SCITEX', dark=True)
+
+# Custom style
+fr.load_style('/path/to/my_style.yaml')
+```
+
+See docs/EXAMPLE_RECIPE.yaml for a full style template.
+
+### Recipe Format (YAML)
+
+``` yaml
+# Timestamp: "2025-12-22 11:53:14 (ywatanabe)"
+# File: ./docs/EXAMPLE_RECIPE.yaml
+# MATPLOTLIB Style Preset
+# =======================
+# Vanilla matplotlib defaults - minimal customization.
+# Use this to reset to standard matplotlib behavior.
+
+axes:
+  width_mm: null   # Use matplotlib default (auto)
+  height_mm: null  # Use matplotlib default (auto)
+  thickness_mm: null  # Use matplotlib default
+
+margins:
+  left_mm: null
+  right_mm: null
+  bottom_mm: null
+  top_mm: null
+
+spacing:
+  horizontal_mm: null
+  vertical_mm: null
+
+fonts:
+  family: null  # matplotlib default (DejaVu Sans)
+  axis_label_pt: null
+  tick_label_pt: null
+  title_pt: null
+  suptitle_pt: null
+  legend_pt: null
+  annotation_pt: null
+
+padding:
+  label_pt: null
+  tick_pt: null
+  title_pt: null
+
+lines:
+  trace_mm: null
+  errorbar_mm: null
+  errorbar_cap_mm: null
+
+ticks:
+  length_mm: null
+  thickness_mm: null
+  direction: null
+  n_ticks: null
+
+markers:
+  size_mm: null
+  scatter_mm: null
+  edge_width_mm: null
+
+legend:
+  frameon: null          # matplotlib default (True)
+  bg: null               # matplotlib default
+  edgecolor: null        # matplotlib default
+  alpha: null            # matplotlib default
+  loc: null              # matplotlib default
+
+output:
+  dpi: 300
+  transparent: false
+  format: "png"
+
+behavior:
+  auto_scale_axes: false
+  hide_top_spine: false
+  hide_right_spine: false
+  grid: false
+
+theme:
+  mode: "light"
+  dark:
+    figure_bg: "#1e1e1e"
+    axes_bg: "#1e1e1e"
+    legend_bg: "#1e1e1e"
+    text: "#d4d4d4"
+    spine: "#3c3c3c"
+    tick: "#d4d4d4"
+    grid: "#3a3a3a"
+  light:
+    figure_bg: "white"
+    axes_bg: "white"
+    legend_bg: "white"
+    text: "black"
+    spine: "black"
+    tick: "black"
+    grid: "#cccccc"
+
+# Standard matplotlib color cycle (tab10)
+colors:
+  palette:
+    - [31, 119, 180]     # tab:blue
+    - [255, 127, 14]     # tab:orange
+    - [44, 160, 44]      # tab:green
+    - [214, 39, 40]      # tab:red
+    - [148, 103, 189]    # tab:purple
+    - [140, 86, 75]      # tab:brown
+    - [227, 119, 194]    # tab:pink
+    - [127, 127, 127]    # tab:gray
+    - [188, 189, 34]     # tab:olive
+    - [23, 190, 207]     # tab:cyan
+
+# EOF
+```
+
+The recipe is human-readable, version-controllable, and inspectable.
+
+
+### API Overview
+
+| Function                      | Description                       |
+| ----------------------------- | --------------------------------- |
+| `fr.subplots()`               | Create a recording-enabled figure |
+| `fr.save(fig, 'fig.png')`     | Save image + recipe               |
+| `fr.reproduce('fig.yaml')`    | Reproduce figure from recipe      |
+| `fr.extract_data('fig.yaml')` | Extract plotted data              |
+| `fr.info('fig.yaml')`         | Inspect recipe metadata           |
+| `fr.load_style()`             | Load style preset (global)        |
+| `fr.list_presets()`           | List available presets            |
+| `fr.crop('fig.png')`          | Crop to content with mm margin    |
+
+
+### Examples
+- 📓 Interactive demo notebook:
+  examples/figrecipe_demo.ipynb
+
+- 🌐 View on nbviewer:
+  https://nbviewer.org/github/ywatanabe1989/figrecipe/blob/main/examples/figrecipe_demo.ipynb
+
+The notebook includes side-by-side comparisons of original and reproduced figures.
+
+## Positioning
+
+FigRecipe is intentionally minimal.
+It focuses on recording, reproduction, and layout fidelity.
+
+Higher-level workflows (figures, tables, statistics, GUIs) are handled in:
+
+FTS (Figure-Table-Statics Bundle) in SciTeX ecosystem (https://scitex.ai/vis/)
+
+
+## License
+
+AGPL-3.0 See [LICENSE](LICENSE)
+.
+
+<!-- EOF -->

figrecipe-0.9.0/.pre-commit-config.yaml

@@ -0,0 +1,25 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.4
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: local
+    hooks:
+      - id: pytest
+        name: pytest
+        entry: python -m pytest tests/ -n auto --dist loadfile -x -q --tb=short
+        language: system
+        types: [python]
+        pass_filenames: false
+        stages: [pre-commit]