Merge pull request #45 from TexasCoding/examples

Release v3.1.12: Enhanced real-time data example with CSV export and charting

Author: TexasCoding

CHANGELOG.md

@@ -14,6 +14,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Migration guides will be provided for all breaking changes
 - Semantic versioning (MAJOR.MINOR.PATCH) is strictly followed
 
+## [3.1.12] - 2025-08-15
+
+### Added
+- **📊 Enhanced Example**: Significantly improved `01_events_with_on.py` real-time data example
+  - Added CSV export functionality for bar data
+  - Interactive candlestick chart generation using Plotly
+  - Automatic prompt after 10 bars to export data and generate charts
+  - Non-blocking user input handling for CSV export confirmation
+  - Proper bar counting and display formatting
+  - Chart opens automatically in browser when generated
+
+### Improved
+- Example now shows last 6 bars instead of 5 for better context
+- Better formatting of price displays with proper currency formatting
+- Clear visual indicators for new bar events
+- More user-friendly prompts and progress indicators
+
+### Dependencies
+- Added optional Plotly dependency for chart generation in examples
+- Example gracefully handles missing Plotly installation
+
 ## [3.1.11] - 2025-08-13
 
 ### Fixed

CLAUDE.md

@@ -288,7 +288,15 @@ async with ProjectX.from_env() as client:
 
 ## Recent Changes
 
-### v3.1.11 - Latest Release
+### v3.1.12 - Latest Release
+- **Enhanced**: Significantly improved `01_events_with_on.py` real-time data example
+  - Added CSV export functionality with interactive prompts
+  - Plotly-based candlestick chart generation
+  - Non-blocking user input handling
+  - Better bar display formatting and visual indicators
+  - Automatic browser opening for generated charts
+
+### v3.1.11
 - **Fixed**: ManagedTrade `_get_market_price()` implementation
   - ManagedTrade can now fetch current market prices from data manager
   - Automatic fallback through multiple timeframes (1sec, 15sec, 1min, 5min)

docs/conf.py

@@ -23,8 +23,8 @@
 project = "project-x-py"
 copyright = "2025, Jeff West"
 author = "Jeff West"
-release = "3.1.11"
-version = "3.1.11"
+release = "3.1.12"
+version = "3.1.12"
 
 # -- General configuration ---------------------------------------------------