plotext-plus 1.0.9__tar.gz → 1.0.10__tar.gz

{plotext_plus-1.0.9 → plotext_plus-1.0.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plotext_plus
-Version: 1.0.9
+Version: 1.0.10
 Summary: Modern terminal plotting library with enhanced visual features, themes, and AI integration
 Project-URL: Homepage, https://github.com/ccmitchellusa/plotext_plus
 Project-URL: Repository, https://github.com/ccmitchellusa/plotext_plus.git
@@ -23,6 +23,7 @@ Classifier: Topic :: Scientific/Engineering :: Visualization
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Terminals
 Requires-Python: >=3.11
+Requires-Dist: chuk-mcp-server>=0.3.5
 Requires-Dist: chuk-term>=0.1.0
 Requires-Dist: shtab>=1.7.2
 Provides-Extra: completion
@@ -30,7 +31,7 @@ Requires-Dist: shtab; extra == 'completion'
 Provides-Extra: image
 Requires-Dist: pillow>=8.4; extra == 'image'
 Provides-Extra: mcp
-Requires-Dist: chuk-mcp-server>=0.2.3; extra == 'mcp'
+Requires-Dist: chuk-mcp-server>=0.3.5; extra == 'mcp'
 Provides-Extra: video
 Requires-Dist: ffpyplayer>=4.3.5; extra == 'video'
 Requires-Dist: opencv-python>=4.5.5; extra == 'video'
@@ -301,3 +302,7 @@ plt.theme('professional')
 plt.plot([1,2,3], [1,4,2])
 plt.show()
 ```
+
+## 🛠️ Development & Build System
+
+Plotext+ includes a comprehensive build system with modern tooling. See **[Build Documentation](docs/build.md)** for complete setup, testing, publishing, and deployment instructions.

{plotext_plus-1.0.9 → plotext_plus-1.0.10}/README.md

@@ -260,3 +260,7 @@ plt.theme('professional')
 plt.plot([1,2,3], [1,4,2])
 plt.show()
 ```
+
+## 🛠️ Development & Build System
+
+Plotext+ includes a comprehensive build system with modern tooling. See **[Build Documentation](docs/build.md)** for complete setup, testing, publishing, and deployment instructions.

plotext_plus-1.0.10/docs/build.md

@@ -0,0 +1,160 @@
+# 🛠️ Development & Build System
+
+Plotext+ includes a comprehensive build system with modern tooling for development, testing, and deployment.
+
+## Quick Development Setup
+
+```bash
+# Clone and setup
+git clone https://github.com/ccmitchellusa/plotext_plus.git
+cd plotext_plus
+
+# Development environment setup  
+make dev          # Install all dependencies + format + test
+make setup        # Alternative: setup development environment
+```
+
+## Build Commands
+
+### **🌱 Environment & Installation**
+```bash
+make install      # Install basic dependencies
+make install-dev  # Install with development tools
+make install-mcp  # Install with MCP server support  
+make install-all  # Install with all optional dependencies
+make update       # Update all dependencies
+```
+
+### **🧪 Testing & Quality**
+```bash
+make test         # Run tests with coverage
+make test-fast    # Run tests without coverage
+make test-mcp     # Test MCP server functionality
+make coverage     # Generate coverage reports
+
+# Code quality
+make lint         # Run full linting suite (ruff + black + isort + mypy)
+make lint-check   # Check linting without fixing
+make format       # Format code (black + isort)
+make ruff         # Ruff linting and formatting
+make black        # Black code formatting
+make isort        # Import sorting
+make mypy         # Type checking
+make bandit       # Security analysis
+```
+
+### **📦 Building & Publishing**
+```bash
+make build        # Build Python package
+make publish      # Build and publish to PyPI (with twine)
+make publish-test # Publish to TestPyPI
+make clean        # Clean build artifacts
+
+# Version management
+make bump-patch   # Bump patch version (1.0.0 → 1.0.1)
+make bump-minor   # Bump minor version (1.0.0 → 1.1.0)  
+make bump-major   # Bump major version (1.0.0 → 2.0.0)
+
+# Combined release workflow
+make release-patch # Bump patch + publish
+make release-minor # Bump minor + publish  
+make release-major # Bump major + publish
+```
+
+### **🐋 Container Operations**
+```bash
+# Docker
+make docker-build    # Build Docker image
+make docker-up       # Start with Docker Compose
+make docker-down     # Stop Docker Compose
+make docker-logs     # View container logs
+make docker-clean    # Clean containers and images
+
+# Podman
+make podman-build    # Build with Podman
+make podman-run-mcp  # Run MCP server container
+make podman-test     # Test container health
+make podman-logs     # Follow container logs
+make podman-stats    # Show resource usage
+make podman-shell    # Interactive shell access
+```
+
+### **☁️ Cloud Deployment**
+```bash
+# IBM Cloud Code Engine
+make ce-push-image   # Push to IBM Container Registry
+make ce-deploy       # Deploy to Code Engine
+make ce-update       # Update existing deployment
+make ce-status       # Check deployment status
+make ce-logs         # View application logs
+make ce-full-deploy  # Complete deployment workflow
+```
+
+### **🎯 Quick Workflows**
+```bash
+make dev       # Development setup (install-all + format + test-fast)
+make check     # Quick validation (lint-check + test-fast)
+make all       # Full pipeline (format + lint + test + build)
+```
+
+### **▶️ Running & Demo**
+```bash
+make run-mcp     # Start MCP server
+make run-demos   # Run interactive examples
+```
+
+### **🔧 Utilities**
+```bash
+make version     # Show version information
+make info        # Show project information  
+make deps        # Show dependency tree
+make help        # Show all available targets
+```
+
+## Project Structure
+
+```
+plotext_plus/
+├── src/plotext_plus/          # 🎯 Main source code
+│   ├── plotting.py           # Core plotting functions  
+│   ├── charts.py             # Chart classes
+│   ├── themes.py             # Theme system
+│   ├── utilities.py          # Helper functions
+│   ├── mcp_server.py         # MCP server (optional)
+│   └── _*.py                 # 🔒 Private modules
+├── examples/                 # Interactive demos
+├── tests/                    # Test suites  
+├── docs/                     # Documentation
+├── .github/workflows/        # CI/CD automation
+├── docker/                   # Container files
+└── Makefile                  # Build system
+```
+
+## Development Workflow
+
+1. **Setup**: `make dev` 
+2. **Code**: Write your changes
+3. **Quality**: `make check` (lint + test)
+4. **Comprehensive**: `make all` (full pipeline)
+5. **Deploy**: `make release-patch` (version + publish)
+
+## CI/CD Integration
+
+The project includes comprehensive GitHub Actions workflows:
+
+- **🔄 CI**: Automated testing, linting, security scanning
+- **🚀 Release**: Automated publishing to PyPI + container registry
+- **🔒 Security**: Daily security scans, dependency updates  
+- **📦 Dependencies**: Weekly automated dependency updates
+
+All workflows use modern tooling (uv, ruff, mypy, pytest) for fast, reliable builds.
+
+## Quality Standards
+
+- **Code Quality**: Ruff + Black + isort for consistent formatting
+- **Type Safety**: MyPy for static type checking
+- **Security**: Bandit for security analysis  
+- **Testing**: Pytest with coverage reporting
+- **Documentation**: Comprehensive docs with examples
+
+Use `make help` to see all available commands with descriptions.

{plotext_plus-1.0.9 → plotext_plus-1.0.10}/docs/notes.md

@@ -98,7 +98,7 @@ plt.test()  # Downloads and displays a test image, then removes it
 - add heatmap plot, as requested in issue [Issue 143](https://github.com/ccmitchellusa/plotext_plus/issues/143)
 - add OHLC date time plot, as requested in issue [Issue 149](https://github.com/ccmitchellusa/plotext_plus/issues/149)
 - add network graphs, as requested in issue [Issue 160](https://github.com/ccmitchellusa/plotext_plus/issues/160)
-- integrate `colorize()` in `text()` and `indicator()` or or any string `label` parameter, as requested in issue [Issue 144](https://github.com/ccmitchellusa/plotext_plus/issues/144); possible idea: `colorize()` to output a `matrix_class()` object
+- integrate `colorize()` in `text()` and `indicator()` or or any string `label` parameter, as requested in issue [Issue 144](https://github.com/ccmitchellusa/plotext_plus/issues/144); possible idea: `colorize()` to output a `MatrixClass()` object
 - allow simple bar plots in matrix of subplots, as requested in issue [Issue 171](https://github.com/ccmitchellusa/plotext_plus/issues/171); this could be possibly extended to allow images also, rendered with fast parameter set to `True`
 - allow user to decide plot legend position and frame
 - allow clickable plots, as requested in issue [Issue 175](https://github.com/ccmitchellusa/plotext_plus/issues/175); this sounds hard!
@@ -125,7 +125,7 @@ plt.test()  # Downloads and displays a test image, then removes it
 - add matrix plot side bar, to connect intensity level with actual matrix value
 - high resolution markers available on Windows and other rarer terminals (under request and not sure how)
 - add method to optionally set the sizes of a matrix of subplots giving priority to the subplots closer to bottom right edge, instead of upper left ones (as by default)
-- convert the class `matrix_class()`, the engine running the plots, in C++ and connect it to the Python code (not sure how and would appreciate some help on this)
+- convert the class `MatrixClass()`, the engine running the plots, in C++ and connect it to the Python code (not sure how and would appreciate some help on this)
 
 
 ### Internal Conventions

plotext_plus-1.0.10/examples/advanced_features.py

@@ -0,0 +1,175 @@
+#!/usr/bin/env python3
+"""
+Advanced Plotext features demonstration.
+Shows banner customization, themes, and complex visualizations.
+"""
+
+import os
+import sys
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src"))
+
+import math
+import random
+
+import plotext_plus as plt
+
+
+def custom_banner_example():
+    """Demonstrate custom banner titles and styling"""
+    plt.log_info("🎨 Demonstrating custom banners...")
+
+    x = list(range(25))
+    y = [10 + 5 * math.sin(i / 3) + random.randint(-2, 2) for i in x]
+
+    # Custom themed banner
+    (
+        plt.Chart(use_banners=True, banner_title="🌊 Signal Processing")
+        .line(x, y, color="cyan", label="Noisy Signal")
+        .title("Real-time Data Analysis")
+        .xlabel("Time Samples")
+        .ylabel("Amplitude")
+        .show()
+    )
+
+
+def scientific_visualization():
+    """Scientific data visualization example"""
+    plt.log_info("🔬 Creating scientific visualization...")
+
+    # Generate experimental data
+    temperature = list(range(20, 101, 5))
+    pressure = [t * 0.8 + random.randint(-5, 5) for t in temperature]
+    theoretical = [t * 0.75 for t in temperature]
+
+    chart = (
+        plt.Chart(use_banners=True, banner_title="🧪 Laboratory Results")
+        .scatter(temperature, pressure, color="red", label="Experimental")
+        .line(temperature, theoretical, color="blue", label="Theoretical")
+        .title("Temperature vs Pressure Analysis")
+        .xlabel("Temperature (°C)")
+        .ylabel("Pressure (kPa)")
+        .show()
+    )
+
+
+def business_dashboard():
+    """Business dashboard example"""
+    plt.log_info("📊 Creating business dashboard...")
+
+    # Revenue data
+    months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun"]
+    revenue = [120, 135, 158, 142, 167, 181]
+    target = [150] * len(months)
+
+    chart = (
+        plt.Chart(use_banners=True, banner_title="💼 Revenue Dashboard")
+        .bar(months, revenue, color="green")
+        .line(list(range(len(months))), target, color="red", label="Target")
+        .title("Monthly Revenue Performance")
+        .show()
+    )
+
+
+def mathematical_functions():
+    """Mathematical function plotting"""
+    plt.log_info("📐 Plotting mathematical functions...")
+
+    x = [i / 10 for i in range(-50, 51)]
+    sin_values = [math.sin(val) for val in x]
+    cos_values = [math.cos(val) for val in x]
+
+    chart = (
+        plt.Chart(use_banners=True, banner_title="📈 Mathematical Functions")
+        .line(x, sin_values, color="blue", label="sin(x)")
+        .line(x, cos_values, color="red", label="cos(x)")
+        .title("Trigonometric Functions")
+        .xlabel("x")
+        .ylabel("f(x)")
+        .show()
+    )
+
+
+def performance_comparison():
+    """Performance comparison chart"""
+    plt.log_info("⚡ Creating performance comparison...")
+
+    algorithms = ["Algorithm A", "Algorithm B", "Algorithm C", "Algorithm D"]
+    execution_times = [2.3, 1.8, 3.1, 1.2]
+    memory_usage = [45, 32, 67, 28]
+
+    # Time comparison
+    plt.quick_bar(
+        algorithms,
+        execution_times,
+        title="Execution Time Comparison",
+        use_banners=True,
+        banner_title="⏱️ Performance Metrics",
+    )
+
+    print("\n" + "-" * 40 + "\n")
+
+    # Memory comparison
+    plt.quick_bar(
+        algorithms,
+        memory_usage,
+        title="Memory Usage Comparison",
+        use_banners=True,
+        banner_title="💾 Memory Analysis",
+    )
+
+
+def output_features_demo():
+    """Demonstrate chuk-term output features"""
+    plt.log_info("🎯 Demonstrating output features...")
+
+    # Various output levels
+    plt.log_info("📋 Processing data...")
+    plt.log_success("✅ Data loaded successfully")
+    plt.log_warning("⚠️ Using default parameters")
+    plt.log_error("❌ Minor calculation error detected")
+
+    # Simple visualization with context
+    x = list(range(8))
+    y = [i**1.5 for i in x]
+
+    plt.log_info("📊 Generating final visualization...")
+
+    chart = (
+        plt.Chart(use_banners=True, banner_title="🎯 Final Results")
+        .scatter(x, y, color="purple", label="Growth Curve")
+        .title("Project Completion Analysis")
+        .xlabel("Weeks")
+        .ylabel("Progress")
+        .show()
+    )
+
+    plt.log_success("🎉 Analysis complete!")
+
+
+def main():
+    """Run all advanced examples"""
+    plt.log_success("🌟 Starting Advanced Plotext Features Demo")
+
+    custom_banner_example()
+    print("\n" + "=" * 60 + "\n")
+
+    scientific_visualization()
+    print("\n" + "=" * 60 + "\n")
+
+    business_dashboard()
+    print("\n" + "=" * 60 + "\n")
+
+    mathematical_functions()
+    print("\n" + "=" * 60 + "\n")
+
+    performance_comparison()
+    print("\n" + "=" * 60 + "\n")
+
+    output_features_demo()
+
+    plt.log_success("✨ All advanced examples completed!")
+
+
+if __name__ == "__main__":
+    main()

{plotext_plus-1.0.9 → plotext_plus-1.0.10}/examples/basic_plots.py

@@ -4,113 +4,127 @@ Basic plotting examples using the new Plotext API with chuk-term integration.
 Demonstrates simple scatter plots, line plots, and bar charts.
 """
 
-import sys
 import os
-sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'src'))
+import sys
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src"))
 
 import plotext_plus as plt
 
+
 def basic_scatter_example():
     """Simple scatter plot example"""
     plt.log_info("Creating basic scatter plot...")
-    
+
     # Sample data
     x = list(range(10))
     y = [i**2 for i in x]
-    
+
     # Traditional API
-    plt.scatter(x, y, color='blue')
+    plt.scatter(x, y, color="blue")
     plt.title("Basic Scatter Plot - Traditional API")
     plt.xlabel("X Values")
     plt.ylabel("Y Values")
     plt.show()
 
+
 def enhanced_scatter_example():
     """Enhanced scatter plot with banner mode"""
     plt.log_info("Creating enhanced scatter plot with banners...")
-    
+
     # Sample data
     x = list(range(15))
-    y = [i*1.5 + (i%3)*2 for i in x]
-    
+    y = [i * 1.5 + (i % 3) * 2 for i in x]
+
     # New object-oriented API with banner
-    chart = (plt.Chart(use_banners=True, banner_title="📊 Enhanced Visualization")
-             .scatter(x, y, color='red', label='Data Points')
-             .title("Enhanced Scatter Plot")
-             .xlabel("Time Steps")
-             .ylabel("Measurements")
-             .show())
+    (
+        plt.Chart(use_banners=True, banner_title="📊 Enhanced Visualization")
+        .scatter(x, y, color="red", label="Data Points")
+        .title("Enhanced Scatter Plot")
+        .xlabel("Time Steps")
+        .ylabel("Measurements")
+        .show()
+    )
+
 
 def line_plot_example():
     """Simple line plot example"""
     plt.log_info("Creating line plot...")
-    
+
     # Sample data
     x = list(range(20))
-    y = [i + (i%5)*1.5 for i in x]
-    
+    y = [i + (i % 5) * 1.5 for i in x]
+
     # Quick function API
     plt.quick_line(
-        x, y,
+        x,
+        y,
         title="Quick Line Plot",
         xlabel="Time",
         ylabel="Value",
         use_banners=True,
-        banner_title="📈 Trend Analysis"
+        banner_title="📈 Trend Analysis",
     )
 
+
 def bar_chart_example():
     """Simple bar chart example"""
     plt.log_info("Creating bar chart...")
-    
+
     # Sample data
-    categories = ['A', 'B', 'C', 'D', 'E']
+    categories = ["A", "B", "C", "D", "E"]
     values = [23, 17, 35, 29, 12]
-    
+
     # Quick bar chart
     plt.quick_bar(
-        categories, values,
+        categories,
+        values,
         title="Sample Bar Chart",
         use_banners=True,
-        banner_title="📊 Category Analysis"
+        banner_title="📊 Category Analysis",
     )
 
+
 def multiple_series_example():
     """Multiple data series on one chart"""
     plt.log_info("Creating multi-series plot...")
-    
+
     x = list(range(12))
-    y1 = [i*2 for i in x]
+    y1 = [i * 2 for i in x]
     y2 = [i**1.5 for i in x]
-    
+
     # Object-oriented API with multiple series
-    chart = (plt.Chart(use_banners=True, banner_title="📈 Comparison Chart")
-             .line(x, y1, color='blue', label='Linear')
-             .scatter(x, y2, color='red', label='Power')
-             .title("Multiple Data Series")
-             .xlabel("X Axis")
-             .ylabel("Y Axis")
-             .show())
+    (
+        plt.Chart(use_banners=True, banner_title="📈 Comparison Chart")
+        .line(x, y1, color="blue", label="Linear")
+        .scatter(x, y2, color="red", label="Power")
+        .title("Multiple Data Series")
+        .xlabel("X Axis")
+        .ylabel("Y Axis")
+        .show()
+    )
+
 
 def main():
     """Run all basic examples"""
     plt.log_success("🚀 Starting Basic Plotext Examples")
-    
+
     basic_scatter_example()
-    print("\n" + "="*50 + "\n")
-    
+    print("\n" + "=" * 50 + "\n")
+
     enhanced_scatter_example()
-    print("\n" + "="*50 + "\n")
-    
+    print("\n" + "=" * 50 + "\n")
+
     line_plot_example()
-    print("\n" + "="*50 + "\n")
-    
+    print("\n" + "=" * 50 + "\n")
+
     bar_chart_example()
-    print("\n" + "="*50 + "\n")
-    
+    print("\n" + "=" * 50 + "\n")
+
     multiple_series_example()
-    
+
     plt.log_success("✅ All basic examples completed!")
 
+
 if __name__ == "__main__":
-    main()
+    main()