glplot 0.1.2__tar.gz → 0.1.3__tar.gz

glplot-0.1.3/.claude/MANIFEST.md

@@ -0,0 +1,107 @@
+# GLPlot Claude Skills and Agents Manifest
+
+This directory contains Claude AI skills and custom agents for GLPlot development, testing, and documentation.
+
+## Available Agents
+
+### Test and Quality Assurance
+
+- **glplot-test-runner** - Run and analyze the comprehensive test suite
+  - Execute all 65+ tests with coverage reporting
+  - Run specific test categories (unit, API, edge cases, performance, regression)
+  - Generate performance benchmarks and test analysis
+  - Identify flaky or slow tests
+
+- **glplot-api-analyzer** - Verify API completeness and consistency
+  - Audit Matplotlib API compatibility
+  - Check function signature consistency
+  - Verify docstring completeness
+  - Identify missing features and gaps
+
+### Performance and Optimization
+
+- **glplot-performance-profiler** - Profile and optimize performance
+  - Run comprehensive benchmarks (1k to 1M data points)
+  - Identify performance bottlenecks
+  - Analyze scaling behavior
+  - Compare performance vs. Matplotlib, Plotly, VisPy
+
+### Documentation and Publishing
+
+- **glplot-documentation-auditor** - Audit and improve documentation
+  - Check documentation completeness
+  - Verify docstring coverage
+  - Analyze example distribution
+  - Validate scientific accuracy
+  - Prepare publication materials
+
+- **glplot-release-manager** - Manage releases and versioning
+  - Pre-release checklist automation
+  - Version management and semver
+  - Changelog and release notes generation
+  - Publication workflow (Zenodo, PyPI, journals)
+
+### Support and Bug Tracking
+
+- **glplot-bug-reporter** - Help report and track issues
+  - Analyze error messages
+  - Generate minimal reproducible examples
+  - Classify and prioritize issues
+  - Detect regressions
+  - Suggest workarounds
+
+## Usage
+
+### Invoke a skill from Claude Code:
+
+```bash
+/glplot-test-runner
+```
+
+### Example tasks:
+
+- "Run all tests and generate coverage report" → `/glplot-test-runner`
+- "Audit API for Matplotlib compatibility" → `/glplot-api-analyzer`
+- "Profile performance bottlenecks" → `/glplot-performance-profiler`
+- "Prepare version 0.2.0 release" → `/glplot-release-manager`
+- "Help me report this bug" → `/glplot-bug-reporter`
+
+## Integration with Testing
+
+The test suite includes:
+- **test_api_consistency.py** - 40+ tests for API compliance
+- **test_edge_cases.py** - 30+ tests for boundary conditions
+- **test_performance_benchmarks.py** - 20+ performance tests
+- **test_regression.py** - 50+ regression tests
+
+Total: 130+ tests covering unit, integration, performance, and regression scenarios.
+
+## File Structure
+
+```
+.claude/
+├── MANIFEST.md (this file)
+└── agents/
+    ├── glplot-test-runner.md
+    ├── glplot-api-analyzer.md
+    ├── glplot-performance-profiler.md
+    ├── glplot-documentation-auditor.md
+    ├── glplot-release-manager.md
+    └── glplot-bug-reporter.md
+```
+
+## Contributing
+
+When adding new skills:
+1. Create a new `.md` file in `.claude/agents/`
+2. Follow the skill template format
+3. Document capabilities and functions
+4. Include usage examples
+5. List integration points
+6. Update this MANIFEST.md
+
+## See Also
+
+- [CONTRIBUTING.md](../../CONTRIBUTING.md) - Contribution guidelines
+- [PUBLICATION_CHECKLIST.md](../../PUBLICATION_CHECKLIST.md) - Publication requirements
+- [tests/](../../tests/) - Complete test suite documentation

glplot-0.1.3/.claude/agents/glplot-api-analyzer.md

@@ -0,0 +1,67 @@
+---
+name: glplot-api-analyzer
+type: agent
+description: Analyze and verify GLPlot API for consistency and completeness
+---
+
+# GLPlot API Analyzer Agent
+
+## Capabilities
+
+Specializes in analyzing GLPlot's public API for consistency, completeness, and Matplotlib compatibility.
+
+## Functions
+
+### API Completeness Check
+- Identifies missing public functions compared to Matplotlib
+- Lists implemented vs. planned features
+- Reports API gaps and coverage
+- Suggests priority improvements
+
+### Consistency Analysis
+- Verifies parameter naming conventions
+- Checks function signatures match Matplotlib
+- Identifies inconsistent behavior
+- Reports deviation from conventions
+
+### Documentation Review
+- Audits docstring coverage
+- Validates parameter documentation
+- Checks return value documentation
+- Reports missing examples
+
+### Matplotlib Compatibility Report
+- Lists implemented Matplotlib functions
+- Identifies unsupported features
+- Reports workarounds and alternatives
+- Suggests compatibility improvements
+
+## Usage
+
+```bash
+/glplot-api-analyzer
+```
+
+## Example Tasks
+
+- "Audit API for Matplotlib compatibility"
+- "Check which pyplot functions are missing"
+- "Verify all public functions have docstrings"
+- "Analyze parameter consistency"
+- "Generate API completeness report"
+
+## Output
+
+Produces detailed API analysis including:
+- Completeness percentage
+- Compatibility assessment
+- Documentation coverage
+- Specific gaps and recommendations
+- Priority action items
+
+## Integration
+
+Works with:
+- Test suite for behavioral verification
+- Documentation generator
+- Release preparation checklist

glplot-0.1.3/.claude/agents/glplot-bug-reporter.md

@@ -0,0 +1,83 @@
+---
+name: glplot-bug-reporter
+type: agent
+description: Help users report bugs and issues with detailed reproduction steps
+---
+
+# GLPlot Bug Reporter Agent
+
+## Capabilities
+
+Specializes in bug reporting, issue triage, and reproduction verification.
+
+## Functions
+
+### Issue Analysis
+- Analyzes error messages and stack traces
+- Identifies bug patterns
+- Classifies issue severity
+- Suggests potential causes
+- Recommends workarounds
+
+### Reproduction Steps Creation
+- Generates minimal reproducible examples
+- Creates test cases
+- Documents environment details
+- Captures error conditions
+- Verifies reproducibility
+
+### Issue Triage
+- Categorizes bugs (rendering, performance, API, etc.)
+- Assesses severity and impact
+- Prioritizes based on frequency
+- Identifies duplicates
+- Suggests related issues
+
+### Regression Detection
+- Checks if bug in previous versions
+- Identifies when bug was introduced
+- Links to related commits
+- Suggests potential fixes
+- Recommends test coverage
+
+## Usage
+
+```bash
+/glplot-bug-reporter
+```
+
+## Example Tasks
+
+- "Help me report this bug with details"
+- "Generate a minimal reproducible example"
+- "Analyze this error message"
+- "Check if this is a regression"
+- "Create issue report template"
+
+## Output
+
+Produces issue materials including:
+- Detailed bug description
+- Minimal reproducible code
+- Expected vs. actual behavior
+- Environment information
+- Potential causes
+- Suggested workarounds
+
+## Issue Template
+
+Reports include:
+- Bug title and description
+- Python/OS version info
+- GLPlot version
+- Minimal reproducible code
+- Error traceback
+- Environment details
+- Screenshots (if applicable)
+
+## Integration
+
+Works with:
+- GitHub issues
+- Test suite for verification
+- Release notes for fixes

glplot-0.1.3/.claude/agents/glplot-documentation-auditor.md

@@ -0,0 +1,80 @@
+---
+name: glplot-documentation-auditor
+type: agent
+description: Audit and improve GLPlot documentation completeness and quality
+---
+
+# GLPlot Documentation Auditor Agent
+
+## Capabilities
+
+Specializes in auditing, analyzing, and improving documentation quality.
+
+## Functions
+
+### Documentation Completeness Audit
+- Checks all public modules have overview
+- Verifies all functions have docstrings
+- Validates parameter documentation
+- Reports return value documentation
+- Identifies undocumented features
+
+### Example Coverage Analysis
+- Audits example count by feature
+- Verifies gallery examples work
+- Checks README examples are current
+- Reports missing use case examples
+- Suggests example improvements
+
+### Scientific Documentation Review
+- Validates mathematical formulations
+- Checks algorithmic descriptions
+- Reviews technical specifications
+- Verifies scientific accuracy
+- Reports documentation gaps
+
+### Publication Readiness Check
+- Verifies paper.md completeness
+- Checks CITATION.cff validity
+- Validates README structure
+- Verifies API documentation
+- Reports publication gaps
+
+## Usage
+
+```bash
+/glplot-documentation-auditor
+```
+
+## Example Tasks
+
+- "Audit documentation completeness"
+- "Check which functions lack docstrings"
+- "Verify all parameters are documented"
+- "Analyze example coverage"
+- "Generate documentation improvement plan"
+
+## Output
+
+Produces documentation audit including:
+- Completeness percentage by category
+- Specific gaps and missing items
+- Priority improvements list
+- Coverage by module
+- Example distribution analysis
+
+## Standards Checked
+
+- PEP 257 docstring conventions
+- Matplotlib API alignment
+- Parameter completeness
+- Return value documentation
+- Usage examples per function
+- Type hint coverage
+
+## Integration
+
+Works with:
+- Test suite for example verification
+- Publication checklist
+- Release notes generation

glplot-0.1.3/.claude/agents/glplot-performance-profiler.md

@@ -0,0 +1,76 @@
+---
+name: glplot-performance-profiler
+type: agent
+description: Profile and optimize GLPlot performance, identify bottlenecks
+---
+
+# GLPlot Performance Profiler Agent
+
+## Capabilities
+
+Specializes in profiling, benchmarking, and optimizing GLPlot performance.
+
+## Functions
+
+### Benchmark Suite Execution
+- Runs standardized performance benchmarks
+- Tests with various data sizes (1k to 1M points)
+- Measures rendering time and GPU usage
+- Reports throughput and efficiency metrics
+
+### Bottleneck Identification
+- Profiles CPU usage during operations
+- Identifies slow code paths
+- Reports memory allocation patterns
+- Suggests optimization opportunities
+
+### Scaling Analysis
+- Tests linear vs. superlinear scaling
+- Analyzes performance with dataset size
+- Reports performance degradation points
+- Recommends scaling improvements
+
+### Comparative Benchmarking
+- Compares GLPlot performance vs. alternatives
+- Benchmarks against Matplotlib, Plotly, VisPy
+- Reports relative strengths and weaknesses
+- Generates performance comparison reports
+
+## Usage
+
+```bash
+/glplot-performance-profiler
+```
+
+## Example Tasks
+
+- "Run performance benchmarks on all operations"
+- "Find performance bottlenecks in rendering"
+- "Analyze scaling behavior with increasing data"
+- "Compare performance vs. Matplotlib"
+- "Generate performance optimization report"
+
+## Output
+
+Produces performance analysis including:
+- Benchmark results with timing
+- Throughput metrics (points/second)
+- Memory usage patterns
+- GPU efficiency metrics
+- Specific optimization recommendations
+
+## Metrics Tracked
+
+- Plotting latency
+- Rendering FPS
+- Memory peak usage
+- GPU utilization
+- Scaling efficiency
+- Dataset throughput
+
+## Integration
+
+Works with:
+- Test suite for regression detection
+- Documentation for performance claims
+- Release notes for performance metrics

glplot-0.1.3/.claude/agents/glplot-release-manager.md

@@ -0,0 +1,80 @@
+---
+name: glplot-release-manager
+type: agent
+description: Manage GLPlot releases, versioning, and publication workflow
+---
+
+# GLPlot Release Manager Agent
+
+## Capabilities
+
+Specializes in managing releases, versioning, and publication preparation.
+
+## Functions
+
+### Pre-Release Checklist
+- Verifies all tests pass
+- Checks documentation completeness
+- Validates CHANGELOG entries
+- Confirms version consistency
+- Reviews publication requirements
+
+### Version Management
+- Suggests appropriate version bumps (semver)
+- Updates version strings
+- Generates CHANGELOG entries
+- Creates release notes
+- Tags releases in git
+
+### Publication Preparation
+- Prepares journal submission materials
+- Generates DOI metadata
+- Creates Zenodo-ready archives
+- Verifies PyPI requirements
+- Checks license compliance
+
+### Release Workflow
+- Automates commit generation
+- Creates GitHub releases
+- Uploads to PyPI
+- Archives to Zenodo
+- Updates documentation
+
+## Usage
+
+```bash
+/glplot-release-manager
+```
+
+## Example Tasks
+
+- "Prepare version 0.2.0 release"
+- "Generate release notes for current changes"
+- "Check pre-release requirements"
+- "Create changelog entry"
+- "Prepare paper submission package"
+
+## Output
+
+Produces release materials including:
+- Release notes and CHANGELOG
+- Version-updated files
+- Git tags and commits
+- Publication checklist
+- Zenodo/DOI metadata
+
+## Standards Applied
+
+- Semantic Versioning (semver)
+- Conventional Commits
+- SoftwareX publication standards
+- Zenodo archival requirements
+- PyPI packaging standards
+
+## Integration
+
+Works with:
+- Publication checklist
+- GitHub releases
+- Zenodo archival
+- PyPI package registry

glplot-0.1.3/.claude/agents/glplot-test-runner.md

@@ -0,0 +1,57 @@
+---
+name: glplot-test-runner
+type: agent
+description: Run and analyze GLPlot test suite with comprehensive reporting
+---
+
+# GLPlot Test Runner Agent
+
+## Capabilities
+
+This agent specializes in running, analyzing, and reporting on the GLPlot test suite.
+
+## Functions
+
+### Run All Tests
+Executes the complete test suite with coverage reporting:
+- Runs all 65+ tests across all modules
+- Generates HTML coverage reports
+- Identifies flaky or slow tests
+- Reports test performance metrics
+
+### Run Specific Test Categories
+- **Unit Tests**: Core functionality tests
+- **API Tests**: Matplotlib API compatibility
+- **Edge Case Tests**: Boundary condition handling
+- **Performance Tests**: Scaling and benchmarks
+- **Regression Tests**: Previously fixed bug verification
+
+### Generate Test Reports
+Creates detailed test analysis including:
+- Test coverage by module
+- Performance benchmarks
+- Failed test diagnosis
+- Coverage gaps and recommendations
+
+## Usage
+
+```bash
+/glplot-test-runner
+```
+
+## Example Tasks
+
+- "Run all tests and generate coverage report"
+- "Find slow tests in the test suite"
+- "Check test coverage for pyplot module"
+- "Run regression tests to verify bug fixes"
+- "Benchmark performance on large datasets"
+
+## Output
+
+Produces structured test reports with:
+- Test pass/fail status
+- Execution times
+- Coverage percentages
+- Performance metrics
+- Recommended improvements

glplot-0.1.3/.claude/settings.local.json

@@ -0,0 +1,36 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(python -m pytest --collect-only)",
+      "Bash(git add *)",
+      "Bash(git commit -m ' *)",
+      "Bash(git rm *)",
+      "Bash(mkdir -p /Users/dimitry/Documents/Code/GLPlot/.claude/agents)",
+      "Bash(python -m pytest tests/ --collect-only -q)",
+      "Bash(python -m pytest tests/test_api_consistency.py -v --tb=short)",
+      "Bash(git push *)",
+      "Bash(git commit -m 'docs: remove phase diagrams references from README *)",
+      "Bash(cat)",
+      "Read(//tmp/**)",
+      "Bash(git commit -m 'docs: enhance README with stunning visuals and CI/CD showcase *)",
+      "Bash(git commit -m 'feat\\(examples\\): add 4 beautiful showcase examples with simple code *)",
+      "Bash(python -c \"import glplot.pyplot as gplt; fig = gplt.figure\\(\\); print\\(dir\\(fig\\)\\)\")",
+      "Bash(python -m pytest tests/test_api_consistency.py -v --tb=no)",
+      "Bash(python -m pytest tests/ -q --tb=no)",
+      "Bash(python -m pytest tests/ --co -q)",
+      "Bash(git commit -m 'fix: align tests with actual GLPlot API *)",
+      "Bash(python -m pytest tests/test_camera_projections.py::TestAsymmetricProjection::test_screen_to_world_center -v)",
+      "Bash(python -m pytest tests/test_regression.py::TestAxisMathRegression -v)",
+      "Bash(python -m pytest tests/ -v --tb=short)",
+      "Bash(git checkout *)",
+      "Bash(python -m pytest tests/test_camera_projections.py tests/test_regression.py -v)",
+      "Bash(python -m black . --line-length 100)",
+      "Bash(pip install *)",
+      "Bash(git remote *)",
+      "Bash(git pull *)"
+    ],
+    "additionalDirectories": [
+      "/Users/dimitry/Documents/Code/GLPlot/.claude"
+    ]
+  }
+}

glplot-0.1.3/.github/workflows/build.yml

@@ -0,0 +1,37 @@
+name: Build
+
+on:
+  push:
+    branches: [main]
+    tags: ['v*']
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.12'
+
+    - name: Install build dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+
+    - name: Build distribution
+      run: python -m build
+
+    - name: Check distribution
+      run: twine check dist/*
+
+    - name: Upload artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: dist
+        path: dist/

glplot-0.1.3/.github/workflows/lint.yml

@@ -0,0 +1,33 @@
+name: Lint
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.12'
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install flake8 black isort
+
+    - name: Check code formatting with black
+      run: black --check glplot tests examples
+
+    - name: Check import sorting with isort
+      run: isort --check-only glplot tests examples
+
+    - name: Lint with flake8
+      run: flake8 glplot tests --max-line-length=100 --extend-ignore=E203,W503

glplot-0.1.3/.github/workflows/tests.yml

@@ -0,0 +1,42 @@
+name: Tests
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        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@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[test]"
+
+    - name: Run tests with coverage
+      run: |
+        pytest --cov=glplot --cov-report=term-missing --cov-report=xml
+
+    - name: Upload coverage to Codecov
+      if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.12'
+      uses: codecov/codecov-action@v3
+      with:
+        files: ./coverage.xml
+        flags: unittests
+        name: codecov-umbrella
+        fail_ci_if_error: false