cPerformanceManager

cPerformanceManager is a high-precision timing and execution-control component for Excel VBA on Windows.

It provides a single, session-bound interface over multiple timing backends and adds a practical runtime-control layer for Excel automation, benchmarking, and environment management.

What this class does

The class provides:

• multiple timing backends under one consistent interface
• low-overhead numeric elapsed-time measurement
• human-readable elapsed-time reporting
• formatting of an already measured elapsed value without taking a second timing sample
• diagnostic helpers for timer characteristics
• benchmark-overhead estimation
• pause / wait helpers
• shared suppression of selected Excel “time-wasters”
• structured checkpoints and report export surfaces

Importantly, time-waster suppression is not limited to timed benchmarks.
It can also be used as a general-purpose Excel/VBA performance aid in heavy procedures even when no elapsed-time measurement is being taken.

Repository map

The current documented repo structure is:

/README.md
/src/cPerformanceManager.cls
/src/M_cPM_TIMEWASTERS.bas
/examples/M_cPM_DEMO.bas
/examples/M_cPM_USAGE_EXAMPLES.bas
/examples/M_DEMO_BUILDER.bas
/test/M_cPM_TEST.bas

Documentation map

• Installation and Import
• Quick Start
• Timer Methods
• Core API
• Checkpoint and Reporting
• Diagnostics and Benchmark Helpers
• Execution Control and Environment
• Time-Waster Suppression
• State Inspection and Debugging
• Strict Mode and Error Behavior
• Examples and Usage Patterns
• Benchmarking Guidance
• Testing and Validation
• Architecture and Internal Design
• FAQ
• Known Limitations
• Version History