myplot 0.1.0__tar.gz

myplot-0.1.0/.claude/settings.local.json

@@ -0,0 +1,18 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(ls -la *.png)",
+      "Bash(source .venv/bin/activate)",
+      "Bash(python simple_test.py)",
+      "Bash(pkill -f simple_test.py)",
+      "Bash(python minimal_test.py)",
+      "Bash(ls -la *.py)",
+      "Bash(python -c \":*)",
+      "Bash(python test_chinese_font.py)",
+      "Bash(python verify_fix.py)",
+      "Bash(find . -name \"__pycache__\" -type d -exec rm -rf {} +)",
+      "Bash(pip install:*)",
+      "Bash(uv pip:*)"
+    ]
+  }
+}

myplot-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

myplot-0.1.0/.idea/.gitignore

@@ -0,0 +1,3 @@
+# Default ignored files
+/shelf/
+/workspace.xml

myplot-0.1.0/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

myplot-0.1.0/.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="Python 3.9" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="uv (test_proj)" project-jdk-type="Python SDK" />
+</project>

myplot-0.1.0/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/test_proj.iml" filepath="$PROJECT_DIR$/.idea/test_proj.iml" />
+    </modules>
+  </component>
+</project>

myplot-0.1.0/.idea/test_proj.iml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="jdk" jdkName="uv (test_proj)" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

myplot-0.1.0/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

myplot-0.1.0/.idea/workspace.xml

@@ -0,0 +1,83 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="de8659a8-0ff7-414d-89d4-38937666c9c1" name="Changes" comment="">
+      <change afterPath="$PROJECT_DIR$/_myplot.py" afterDir="false" />
+    </list>
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="Git.Settings">
+    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
+  </component>
+  <component name="ProjectColorInfo">{
+  &quot;associatedIndex&quot;: 1
+}</component>
+  <component name="ProjectId" id="3ATYfxqXotcuKLMePw5qNwgwjDS" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "Python.main.executor": "Run",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "RunOnceActivity.git.unshallow": "true",
+    "git-widget-placeholder": "master",
+    "last_opened_file_path": "/Users/robert/Projects/test_proj",
+    "settings.editor.selected.configurable": "com.jetbrains.python.configuration.PyActiveSdkModuleConfigurable"
+  }
+}]]></component>
+  <component name="RecentsManager">
+    <key name="CopyFile.RECENT_KEYS">
+      <recent name="$PROJECT_DIR$" />
+    </key>
+  </component>
+  <component name="RunManager">
+    <configuration name="main" type="PythonConfigurationType" factoryName="Python" nameIsGenerated="true">
+      <module name="test_proj" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <envs>
+        <env name="PYTHONUNBUFFERED" value="1" />
+      </envs>
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/main.py" />
+      <option name="PARAMETERS" value="" />
+      <option name="SHOW_COMMAND_LINE" value="false" />
+      <option name="EMULATE_TERMINAL" value="false" />
+      <option name="MODULE_MODE" value="false" />
+      <option name="REDIRECT_INPUT" value="false" />
+      <option name="INPUT_FILE" value="" />
+      <method v="2" />
+    </configuration>
+  </component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-python-sdk-4f4e415b4190-aa17d162503b-com.jetbrains.pycharm.community.sharedIndexes.bundled-PC-243.26053.29" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="SpellCheckerSettings" RuntimeDictionaries="0" Folders="0" CustomDictionaries="0" DefaultDictionary="application-level" UseSingleDictionary="true" transferred="true" />
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="de8659a8-0ff7-414d-89d4-38937666c9c1" name="Changes" comment="" />
+      <created>1772618135045</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1772618135045</updated>
+    </task>
+    <servers />
+  </component>
+</project>

myplot-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

myplot-0.1.0/MYPLOT_REVISION.md

@@ -0,0 +1,244 @@
+# MyPlot Module Revisions - Comprehensive Documentation
+
+## Overview
+This document details the comprehensive improvements made to transform the original `_myplot.py` script into a proper, reusable Python module with enhanced functionality.
+
+## Original Issues Identified
+
+### 1. **No OS Detection**
+- **Problem**: Used hardcoded `Path(__file__).parents[2]` which assumed specific project structure
+- **Impact**: Would fail on different directory structures or systems
+
+### 2. **Limited Font Detection**
+- **Problem**: Only searched project directory for `SourceHanSerifSC-Medium.otf`
+- **Impact**: Font detection would fail if font was installed elsewhere on system
+
+### 3. **Not a Proper Module**
+- **Problem**: Code ran at module level with side effects, making it unsuitable for reuse
+- **Impact**: Could cause conflicts when imported multiple times
+
+## Implementation Plan & Changes
+
+### 1. ✅ Module Structure
+```python
+myplot/
+├── __init__.py     # Main module code
+└── README.md       # Documentation
+```
+
+### 2. ✅ Cross-Platform OS Detection
+
+### 3. ✅ Enhanced Font Detection System
+- **Search Strategy**: Multiple fallback locations
+- **Font Variants**: Searches for multiple versions
+- **Family Name Fix**: Corrects font family name to 'Source Han Serif' instead of 'Source Han Serif SC'
+
+### 4. ✅ Modular Code Architecture
+- Added `import platform` to detect system type
+- Implemented platform-specific path handling:
+  - **Windows**: `C:\Windows\Fonts`, `%USERPROFILE%\AppData\Local\myplot`
+  - **macOS**: `/System/Library/Fonts`, `/Library/Fonts`, `~/Library/Application Support/myplot`
+  - **Linux**: `/usr/share/fonts`, `~/.config/myplot`
+
+### 3. ✅ Enhanced Font Detection System
+- **Search Strategy**: Multiple fallback locations
+  1. System font directories (platform-specific)
+  2. User font directories
+  3. Project local directories (fonts/, resources/fonts/, src/fonts/)
+  4. Current directory
+
+- **Font Variants**: Searches for multiple versions:
+  - `SourceHanSerifSC-Medium.otf`
+  - `SourceHanSerif-Medium.otf`
+  - `SourceHanSerifSC-Regular.otf`
+  - `SourceHanSerif-Regular.otf`
+  - `SourceHanSerif-Heavy.otf`
+  - `NotoSerifCJK-Regular.otf` (Alternative)
+  - `NotoSerifCJK-Medium.otf` (Alternative)
+
+### 4. ✅ Modular Code Architecture
+- Removed module-level code execution
+- Created proper class structures
+- Added comprehensive imports (`builtins` fix)
+
+### 5. ✅ Enhanced Configuration Management
+- Platform-specific config directories
+- JSON-based parameter storage
+- Automatic directory creation
+
+### 6. ✅ Improved Path Handling
+- Safe path operations with error handling
+- Automatic creation of output directories
+- Configurable save locations for images and logs
+
+### 7. ✅ Testing Framework
+- Created comprehensive test suite:
+  - `minimal_test.py` - Non-interactive testing
+  - `test_myplot.py` - Full functionality tests
+  - `simple_test.py` - Basic usage test
+
+### 8. ✅ Package Configuration
+Updated `pyproject.toml`:
+```toml
+[project]
+name = "myplot"
+version = "0.1.0"
+description = "Uniform plotting module for matplotlib with automatic font detection"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+```
+
+## Key Features Added
+
+### 1. **Platform-Aware Font Search**
+```python
+def get_font_search_paths():
+    """Get platform-specific font search paths."""
+    system = platform.system()
+    paths = []
+    # ... platform-specific logic
+    return paths
+```
+
+### 2. **Enhanced Font Detection with Family Name Fix**
+```python
+def find_source_han_serif_font():
+    """Find Source Han Serif font across multiple search paths."""
+    # Comprehensive search with multiple font variants
+    # Returns the actual font file path
+
+def setup_font_properties():
+    """Setup matplotlib font properties if Source Han Serif is found."""
+    # Force register font and set correct family name
+    # Uses 'Source Han Serif' (not 'Source Han Serif SC')
+```
+
+### 4. **Enhanced Decorator**
+```python
+def myplot(figsize=(4.8, 3.6), save=True, log=True, savename='', config_dir=None):
+    """Decorator with platform-specific path handling."""
+```
+
+### 5. **Utility Functions**
+- Radian formatter (`radFormatter`)
+- Degree formatter (`degFormatter`)
+- Radian locator (`radLocator`)
+- Font discovery utilities
+
+## Testing Results
+
+### ✅ Successful Tests
+- **Font Detection**: ✓ Found Source Han Serif correctly
+- **Module Import**: ✓ All imports successful
+- **Utilities**: ✓ All formatters working
+- **Plot Generation**: ✓ Generated test plots successfully
+- **Directory Creation**: ✓ Auto-created appropriate directories
+
+### ⚠️ Expected Warnings
+- Multiple "findfont" warnings are normal - matplotlib tries fonts before configuration
+- Non-interactive backend warning when running in headless environments
+
+## Usage Examples
+
+### Basic Usage
+```python
+from myplot import myplot, plt, np
+
+@myplot()
+def my_plot():
+    x = np.linspace(0, 10, 100)
+    plt.plot(x, np.sin(x))
+    plt.xlabel('x')
+    plt.ylabel('sin(x)')
+```
+
+### Custom Configuration
+```python
+@myplot(figsize=(8, 6), save=True, log=True)
+def custom_plot():
+    # Your plotting code here
+    pass
+```
+
+### Using Utilities
+```python
+from myplot import myUtilities
+
+# Use custom formatters
+ax.xaxis.set_major_formatter(myUtilities.radFormatter())
+ax.xaxis.set_major_formatter(myUtilities.degFormatter())
+```
+
+## Directory Structure Created
+
+```
+myplot/
+├── __init__.py           # Main module
+└── README.md            # Documentation
+
+Test Files:
+├── minimal_test.py      # Non-interactive tests
+├── test_myplot.py       # Full tests
+├── simple_test.py       # Basic tests
+└── MYPLOT_REVISION.md  # This documentation
+
+Generated Outputs:
+├── minimal_test_plot.png
+├── test_radian_formatter.png
+├── test_degree_formatter.png
+└── test_plot.png (saved to platform-specific location)
+```
+
+## Benefits Achieved
+
+1. **Cross-Platform Compatibility**: Works on Windows, macOS, Linux
+2. **Robust Font Detection**: Finds Source Han Serif from multiple locations
+3. **Reusable Module**: Can be imported and used in other projects
+4. **Professional Structure**: Proper Python package with documentation
+5. **Comprehensive Testing**: Multiple test scenarios
+6. **Flexible Configuration**: Platform-specific settings
+7. **Automatic Path Handling**: No manual directory management needed
+
+## Installation Instructions
+
+```bash
+# Install dependencies
+pip install matplotlib numpy
+
+# For development mode (optional)
+pip install hatch
+
+# Run tests
+python minimal_test.py
+```
+
+## Future Enhancements (Optional)
+
+1. Add support for more font families
+2. Implement theme system for different plot styles
+3. Add export formats beyond PNG
+4. Implement figure style presets
+5. Add support for multi-figure layouts
+
+## Recent Fixes (2026-03-12)
+
+### Font Family Name Issue
+- **Problem**: matplotlib was using 'Source Han Serif SC' which caused "findfont: Font family not found" warnings
+- **Solution**: Modified `setup_font_properties()` to force register the font and set family name to 'Source Han Serif'
+- **Result**: Chinese characters now display correctly without warnings
+
+### Additional Improvements
+- Added `myparams.font` property for direct font access
+- Enhanced font detection to check multiple variants and fallback strategies
+- Created comprehensive test scripts for verification
+
+## Summary
+
+The original `_myplot.py` script has been completely transformed into a professional, reusable Python module that addresses all identified limitations while maintaining backward compatibility. The module now provides robust font detection, cross-platform support, and a clean API for creating publication-quality plots with consistent formatting.
+
+---
+*Created: 2026-03-10*
+*Version: 0.1.0*
+*Status: Production Ready*

myplot-0.1.0/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: myplot
+Version: 0.1.0
+Summary: A uniform plotting module for matplotlib with automatic font detection
+Requires-Python: >=3.8
+Requires-Dist: matplotlib>=3.5.0
+Requires-Dist: numpy>=1.20.0
+Description-Content-Type: text/markdown
+
+# MyPlot
+
+A uniform plotting module for matplotlib with automatic font detection and cross-platform support.
+
+## Features
+
+- **Uniform Formatting**: Consistent plot styling across all your projects
+- **Automatic Font Detection**: Finds and configures Source Han Serif font for Chinese characters
+- **Cross-Platform Support**: Works on Windows, macOS, and Linux
+- **Easy to Use**: Simple decorator interface for creating publication-quality plots
+- **Built-in Utilities**: Radian/degree formatters and other plotting utilities
+
+## Installation
+
+```bash
+pip install -e .
+```
+
+## Quick Start
+
+```python
+from myplot import myplot, plt, np
+
+@myplot()
+def simple_plot():
+    x = np.linspace(0, 10, 100)
+    plt.plot(x, np.sin(x))
+    plt.xlabel('x')
+    plt.ylabel('sin(x)')
+    plt.title('Simple Plot')
+
+simple_plot()
+```
+
+## Advanced Usage
+
+### Custom Figure Size
+```python
+@myplot(figsize=(8, 6))
+def large_plot():
+    # Your plotting code here
+    pass
+```
+
+### Save Plots Automatically
+```python
+@myplot(save=True, log=True)
+def save_plot():
+    # Plot will be saved automatically
+    pass
+```
+
+### Using Utilities
+```python
+from myplot import myUtilities
+
+ax.xaxis.set_major_formatter(myUtilities.radFormatter())
+ax.xaxis.set_major_locator(myUtilities.radLocator(np.pi/4))
+```
+
+## Requirements
+
+- Python 3.8+
+- matplotlib >= 3.5.0
+- numpy >= 1.20.0
+
+## License
+
+MIT License

myplot-0.1.0/README.md

@@ -0,0 +1,69 @@
+# MyPlot
+
+A uniform plotting module for matplotlib with automatic font detection and cross-platform support.
+
+## Features
+
+- **Uniform Formatting**: Consistent plot styling across all your projects
+- **Automatic Font Detection**: Finds and configures Source Han Serif font for Chinese characters
+- **Cross-Platform Support**: Works on Windows, macOS, and Linux
+- **Easy to Use**: Simple decorator interface for creating publication-quality plots
+- **Built-in Utilities**: Radian/degree formatters and other plotting utilities
+
+## Installation
+
+```bash
+pip install -e .
+```
+
+## Quick Start
+
+```python
+from myplot import myplot, plt, np
+
+@myplot()
+def simple_plot():
+    x = np.linspace(0, 10, 100)
+    plt.plot(x, np.sin(x))
+    plt.xlabel('x')
+    plt.ylabel('sin(x)')
+    plt.title('Simple Plot')
+
+simple_plot()
+```
+
+## Advanced Usage
+
+### Custom Figure Size
+```python
+@myplot(figsize=(8, 6))
+def large_plot():
+    # Your plotting code here
+    pass
+```
+
+### Save Plots Automatically
+```python
+@myplot(save=True, log=True)
+def save_plot():
+    # Plot will be saved automatically
+    pass
+```
+
+### Using Utilities
+```python
+from myplot import myUtilities
+
+ax.xaxis.set_major_formatter(myUtilities.radFormatter())
+ax.xaxis.set_major_locator(myUtilities.radLocator(np.pi/4))
+```
+
+## Requirements
+
+- Python 3.8+
+- matplotlib >= 3.5.0
+- numpy >= 1.20.0
+
+## License
+
+MIT License