Metadata-Version: 2.4
Name: logbuffer
Version: 0.1.0
Summary: Capture execution context in memory and emit buffered diagnostic events only when an operation fails.
Author-email: Ehsan Karbasian <ehsan.karbasian@gmail.com>
Project-URL: Homepage, https://github.com/ehsankarbasian/Log-Buffer
Project-URL: Repository, https://github.com/ehsankarbasian/Log-Buffer
Keywords: logging,debugging,diagnostics,exceptions,failure,buffer,context,observability
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Logging
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.7
Description-Content-Type: text/markdown

# LogBuffer

LogBuffer captures execution context as structured events in memory and emits it only when an operation fails.

It is designed for diagnostics in code paths where logging every intermediate state change would be noisy, but losing that context during an exception makes debugging difficult.

LogBuffer currently provides:

- `MemoryEventBuffer` for temporary in-memory event collection
- `VerboseDict` for recording dictionary mutations as diagnostic events
- `FailureContext` for flushing buffered events when an exception escapes a scope
- `ConsoleConsumer` for rendering captured events to the terminal
- 
