2.2.0

🚀 Major Features

Python Debugging with VSCode

Full IDE debugging support for Python scripts in Revit:

• VSCode Debugger Integration

  • Set breakpoints directly in VSCode
  • Step through code execution (F10, F11)
  • Inspect variables and Revit API objects
  • Debug console for expression evaluation
  • Conditional breakpoints support
  • Visual connection status indicator (🔴/🟢)

  

• Technical Implementation

  • debugpy integration via PEP 723 automatic installation
  • Configurable debug port (default: 5678)
  • In-process debug adapter for seamless integration
  • Connection status monitoring in UI
  • Non-blocking - scripts run normally without debugger attached

• New Components

  • PythonInitializer - Manages Python runtime and debugpy listener
  • IsDebuggerConnected property - Real-time connection status
  • Debug port configuration in General Settings
  • Status indicator in Trace panel

Documentation:

• Python Debugging Guide
• Demo script: debugpy_script.py

🎯 New Features

PythonNet3 Interface Implementation Demo

• Interface Implementation Workaround
  • Added selectionfilter_script.py demonstrating __namespace__ pattern
  • Shows how to implement .NET interfaces (e.g., ISelectionFilter) in PythonNet3
  • Documents runtime overhead trade-off for dynamic type checking

🔧 Improvements

Python Execution

• Streamlined Script Execution
  • Refactored PythonExecutor for cleaner scope management
  • Improved script content execution flow
  • Better separation of concerns between initialization and execution
  • Enhanced error handling and cleanup

Stub Generation

• Enhanced Method Writing
  • Improved generic type handling in stub generation
  • Better overload detection and signature writing
  • More accurate property accessor detection
  • Enhanced type mapping for complex .NET types

📚 Documentation

Comprehensive Documentation Updates

• README Enhancements

  • Redesigned for better first impression
  • Visual-first approach with demos and context
  • Clear value proposition and target audience
  • Improved structure and navigation
  • Added comparison tables (vs pyRevit, Python ecosystems)

• Wiki Updates

  • New dedicated Python Debugging page
  • Updated Python Execution with debugger info
  • Revised vs pyRevit to focus on target audiences
  • Updated Python Ecosystems with objective analysis
  • Simplified CodeExecute Overview to be true overview
  • Enhanced Dashboard Example with accurate architecture

• Architecture Documentation

  • Converted text diagrams to Mermaid charts for better readability
  • Updated PythonDemo architecture with debugging workflow
  • Improved cross-repo link handling (relative paths → URLs)
  • Removed architecture details from Wiki (moved to docs/)

Full changelog: 2.1.1...2.2.0

2.1.1

🎯 New Features

• Python UV Installer Improvements
  • Added robust UV installation and update management flow
  • Improved detection and handling for local UV binaries
  • Enhanced reliability for Python package tooling bootstrap

🔧 Improvements

• CI Workflow Enhancements

  • Compile workflow now builds per-Revit version via dynamic matrix
  • Matrix versions are derived from source/Directory.Build.props to avoid hardcoded values
  • Added workflow concurrency controls with auto-cancel on newer runs
  • Added cross-workflow lock so compile and release do not run in parallel

• Build Configuration Flexibility

  • Exposed build configuration patterns as Nuke parameter for targeted CI builds

🛠️ Technical Changes

• Updated dependency definitions for Python/UV execution path
• Refined UV resource handling in project configuration

---

Stats: 9 files changed, 221 insertions(+), 34 deletions(-)

Full changelog: 2.1.0...2.1.1

2.0.1

Fixed

• Ensure UI thread handling for open/close FloatingWindow

Documentation

• Updated usage instructions in README
• Clarified Trace methods support for Geometry and Pretty JSON

Full changelog: 2.0.0...2.0.1

2.0.0

Breaking Changes

• Dropped Revit 2021 Support - Minimum supported version is now Revit 2022
• Removed SQLite Log Format - SQLite (.db) logging format has been removed. Use JSON or CLEF formats for structured logging
• Removed CLEF Log Format - CLEF (.clef) format has been removed. Use JSON format for Seq integration

Added

• WPF Trace Listener

  • Capture WPF binding errors and trace output directly in the log panel
  • Configurable WPF trace level (Off, Error, Warning, Information, Verbose)
  • Helps debug XAML binding issues without external tools

• Filter Keywords for Log Level Detection

  • Automatic log level detection based on message content
  • Customizable keywords for each log level (Information, Warning, Error, Critical)
  • Default keywords: info,success,completed for Info, warning,warn,caution for Warning, etc.
  • Supports prefix detection: [INFO], [WARN], [ERROR], [FATAL], [DEBUG]

• Pretty JSON Output

  • Enable formatted JSON output for complex objects in trace logs
  • Objects logged via Trace.WriteLine(object) are automatically serialized
  • Configurable via settings UI

• Revit Enrichers

  • Add Revit context to every log entry automatically
  • Available enrichers: Revit Version, Document Title, Document Path, Model Path, Addin ID
  • Configurable via settings UI

• New Single-Page Settings UI

  • All settings now accessible in a single integrated panel
  • No more separate settings window - everything in the dockable panel
  • Cleaner, more intuitive configuration experience

• Live Geometry Count Badge

  • Real-time badge showing count of geometry objects currently visualized
  • Visual feedback for geometry pool status
  • Helps track visualization state at a glance

• Python Stack Trace Support

  • Enhanced logging for Python/pyRevit scripts with full traceback
  • PyTrace.Write(message, traceback) bridge for Python integration
  • Respects stack trace depth settings
  • Helper script: source/RevitDevTool/Logging/Python/trace.py

• Auto-Clean Log Files

  • Automatically clean old log files based on rolling interval
  • Prevents log folder from growing indefinitely

• Process ID in Log Files

  • Log file names now include process ID for multi-instance scenarios
  • Easier identification of logs from different Revit sessions

Changed

• Logging Architecture Refactored

  • Complete reorganization of logging infrastructure
  • Improved separation of concerns between trace listener and logger adapter
  • Better extensibility for future logging backends

• UI Enhancements

  • Improved settings panel layout and organization
  • Better visual feedback for pending changes
  • Enhanced theme consistency

Fixed

• Stack trace now properly included in UI output
• Settings reset functionality improved
• geometry rendering ratio calculations

Full changelog: 1.4.0...2.0.0

1.4.0

Added

• Automatic Floating Window on Trace Events

  • Floating trace log window automatically opens when trace events occur and no document is open
  • Listener monitors document open/close events to manage window visibility
  • Auto-hides when document is opened to avoid interference

• External File Logging System

  • Multiple log file format support:
    • Plain Text (.log) - Human-readable format with timestamps
    • JSON (.json) - Structured JSON format for parsing
    • CLEF (.clef) - Compact Log Event Format for analysis tools like Seq
    • SQLite (.db) - Database format for querying and data analysis
  • Configurable rolling intervals (daily, hourly, etc.)
  • File size limit controls
  • Shared file access support for multi-process logging

• Log Configuration UI

  • Settings panel for managing log output preferences
  • Enable/disable external file logging
  • Select log format and output path
  • Configure rolling intervals and file management
  • Stack trace inclusion toggle with depth control

• Enhanced Stack Trace in Logs

  • Stack traces now show actual caller location (method, file, line number)
  • Automatic filtering of framework and system internals
  • Configurable stack trace depth
  • Displays call chain in readable format (e.g., MyClass.Execute:42 > Helper.Process:18)
  • Includes Revit version and active document name in structured log context

Changed

• Visualization System

  • Adjusted default axis length for better scale
  • Optimized geometry rendering pipeline

• UI Adjustments

  • Disabled window backdrop (mica/acrylic) to fix RichTextBox overlay issues
  • Adjusted glass frame thickness for better WinForms control integration

Fixed

• Proper cleanup of trace listener when Revit closes
• Window theme subscription leaks on close

Full changelog: 1.3.3...1.4.0

1.3.3

Changed

• Updated manual test case: batch log

Fixed

• Clear method in TraceLog - text not actually clearing and reappearing on next trace event due to OnIdling event handler interference
• Curve Test case - cast to Edge instead of Curve

Full changelog: 1.3.2...1.3.3

1.3.2

Added

• DockablePane visibility tracking to automatically subscribe/unsubscribe TraceLog when panel is shown/hidden
• Proper lifecycle management for TraceLog with subscription state tracking

Changed

• Changed default AxisLength in XyzVisualizationSettings from 6 to 2 for better default visualization scale
• Changed Settings window startup location from CenterScreen to CenterOwner
• Improved TraceLog initialization and disposal flow with better state management
• Refactored TraceLog to completely unsubscribe when panel is not visible
• Enhanced theme change handling with proper dispatcher invocation
• Removed unused external event handlers (AsyncEventHandler, AsyncCollectionEventHandler, IdlingEventHandler)
• Updated .csproj repack configuration to exclude only UI assemblies

Fixed

• Prevented multiple Settings windows from opening simultaneously by controlling OpenSettings command execution state
• TraceLog resource cleanup and memory management
• Trace listeners registration to ensure persistence across application lifecycle

Full changelog: 1.3.1...1.3.2

1.3.1

Fixed

• Removed PixiEditor.ColorPicker to avoid conflicts between Microsoft.Xaml.Behaviors.Wpf and other add-ins.

Full changelog: 1.3.0...1.3.1

1.3.0

Added

• Settings integration
  • Visualization options
  • Theme management options
• Suppor Outline object

Fixed

• Revit 2026 context isolation
• Ensure Trace.Listeners are re-added if removed by other add-ins

Full changelog: 1.2.0...1.3.0

1.2.0

Added

• DirectContext3D visualization support for geometry rendering
• Support for visualizing multiple geometry types (Solid, Face, Curve, XYZ, CurveLoop, Outline)
• Trace support for ICollection<object> and IEnumerable<CurveLoop>
• Serilog sink for WinForms RichTextBox with theme support
• Nice3Point packages integration
• New designed icons and button icons

Fixed

• Multiple geometries visualization
• Face normal vector visualization
• SolidVisualizationServer rendering issues
• VisualizationServerController startup
• Exception handling when retrieving bounding box of solids
• Skip solids with zero volume in bounding box calculation

Changed

• Improved theme management and resource handling
• Enhanced TraceLog with RichTextBox using dynamic theme and max log lines
• Optimized bounding box calculations by transforming corners individually
• Streamlined buffer disposal and clearing methods
• Refactored XYZ rendering methods with updated color settings and axis length support
• Updated PolylineVisualizationServer rendering
• Improved safe server registration
• Better start/stop mechanism for Visualization server

Performance

• Disposed unmanaged resources properly

Documentation

• Added RenderHelper in-depth documentation
• Updated README with Acknowledgments section
• Refined geometry visualization details in README
• Streamlined table of contents and updated Python references for Revit 2025

Full changelog: 1.1.1...1.2.0