mermaid-trace 0.5.3.post0__py3-none-any.whl → 0.6.1.post0__py3-none-any.whl

{mermaid_trace-0.5.3.post0.dist-info → mermaid_trace-0.6.1.post0.dist-info}/RECORD

@@ -1,6 +1,7 @@
 mermaid_trace/__init__.py,sha256=EnAsz6R6ag4dtabdHEg1wdB2k7V1uwmwpYTTC41GQX4,6721
-mermaid_trace/cli.py,sha256=g7Qriiox9YqfJutUntE1a7GwByg62wGwQcLfpvicjT8,15076
+mermaid_trace/cli.py,sha256=FCbm9kHf7B74bvkRv_k7stTeG7S7GqNSITmUQW1kJEA,16173
 mermaid_trace/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mermaid_trace/server.py,sha256=1nNIS6pNAn3_XCwuoUkKIOsq4GJK5o33QFzv-hh-IJY,15458
 mermaid_trace/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mermaid_trace/core/config.py,sha256=akTOc3m_bzcZ7e1Qtf1n5Ct9Dj8XPTTcWzATG3-qJHw,1890
 mermaid_trace/core/context.py,sha256=wr-Ys3c6PsYCtbPUsQTrnaciSkP-fofxOewo4oZ27QM,8556
@@ -10,10 +11,11 @@ mermaid_trace/core/formatter.py,sha256=3KEq236E3GAj_j53MuBM2ndWm7Kx4KeywJWmoY5o5
 mermaid_trace/core/utils.py,sha256=FagsMYLZcbmOgKmRo3v9tcRNVIpuc1YEKTAjcRk7keY,3410
 mermaid_trace/handlers/async_handler.py,sha256=WmLcULXHasapt7-W0p_Eltjmwvlq6r6BS6pViuseZ4w,8252
 mermaid_trace/handlers/mermaid_handler.py,sha256=Czar6JYSPTu5L1fQC0I8v1UpToD6aE_r96IkPpRSByw,6142
-mermaid_trace/integrations/__init__.py,sha256=uU_8E1tlP327Fn79kvzlgEdoiIpQLsWJl3BgyqgsFMQ,104
+mermaid_trace/integrations/__init__.py,sha256=stWAHIL1zv21foaXFXZ_3SLxJ8icN0YFGWOvvHERCDI,269
 mermaid_trace/integrations/fastapi.py,sha256=6LRs4Z508l38ymfj5SP39vOV6OLfYLRkpxyL_SxvudM,9483
-mermaid_trace-0.5.3.post0.dist-info/METADATA,sha256=FR1kgM-wlTzrFasLpIeqbWbV_X3h3TwwUkxQCvgbvo0,9959
-mermaid_trace-0.5.3.post0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-mermaid_trace-0.5.3.post0.dist-info/entry_points.txt,sha256=WS57KT_870v0A4B87QDjQUqJcddMQxbCQyYeczDAX34,57
-mermaid_trace-0.5.3.post0.dist-info/licenses/LICENSE,sha256=BrBog1Etiq9PdWy0SVQNVByIMD9ss4Edz-R0oXt49zA,1062
-mermaid_trace-0.5.3.post0.dist-info/RECORD,,
+mermaid_trace/integrations/langchain.py,sha256=NAbfxAWybbH94ZKIgPsD6zCCc1j5gVXqUdtYlwVUVRs,14019
+mermaid_trace-0.6.1.post0.dist-info/METADATA,sha256=ZW8sme2ss9f6eylmbMCxVO5Q6869XCPW8p2aSs9uyBM,11099
+mermaid_trace-0.6.1.post0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+mermaid_trace-0.6.1.post0.dist-info/entry_points.txt,sha256=WS57KT_870v0A4B87QDjQUqJcddMQxbCQyYeczDAX34,57
+mermaid_trace-0.6.1.post0.dist-info/licenses/LICENSE,sha256=BrBog1Etiq9PdWy0SVQNVByIMD9ss4Edz-R0oXt49zA,1062
+mermaid_trace-0.6.1.post0.dist-info/RECORD,,

mermaid_trace-0.5.3.post0.dist-info/METADATA

@@ -1,232 +0,0 @@
-Metadata-Version: 2.4
-Name: mermaid-trace
-Version: 0.5.3.post0
-Summary: Visualize your Python code execution flow as Mermaid Sequence Diagrams.
-Project-URL: Documentation, https://github.com/xt765/mermaid-trace#readme
-Project-URL: Changelog, https://github.com/xt765/mermaid-trace/blob/main/docs/en/CHANGELOG.md
-Project-URL: Issues, https://github.com/xt765/mermaid-trace/issues
-Project-URL: Source, https://github.com/xt765/mermaid-trace
-Author-email: xt765 <xt765@foxmail.com>
-License: MIT License
-        
-        Copyright (c) 2026 xt765
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-License-File: LICENSE
-Keywords: asyncio,logging,mermaid,mermaid-trace,sequence-diagram,trace,visualization
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Programming Language :: Python :: Implementation :: PyPy
-Classifier: Topic :: Software Development :: Debuggers
-Classifier: Topic :: System :: Logging
-Requires-Python: >=3.10
-Requires-Dist: typing-extensions>=4.0.0
-Requires-Dist: watchdog>=2.0.0
-Provides-Extra: all
-Requires-Dist: fastapi>=0.100.0; extra == 'all'
-Provides-Extra: dev
-Requires-Dist: fastapi>=0.100.0; extra == 'dev'
-Requires-Dist: httpx; extra == 'dev'
-Requires-Dist: mypy; extra == 'dev'
-Requires-Dist: pytest; extra == 'dev'
-Requires-Dist: pytest-asyncio; extra == 'dev'
-Requires-Dist: pytest-cov; extra == 'dev'
-Requires-Dist: ruff; extra == 'dev'
-Provides-Extra: fastapi
-Requires-Dist: fastapi>=0.100.0; extra == 'fastapi'
-Description-Content-Type: text/markdown
-
-# MermaidTrace: The Python Logger That Draws Diagrams
-
-🌐 **Language**: [English](README.md) | [中文](README_CN.md)
-
-[![PyPI version](https://img.shields.io/pypi/v/mermaid-trace.svg?style=flat-square&color=blue)](https://pypi.org/project/mermaid-trace/)
-[![Python Versions](https://img.shields.io/pypi/pyversions/mermaid-trace.svg?style=flat-square&color=blue)](https://pypi.org/project/mermaid-trace/)
-[![License](https://img.shields.io/github/license/xt765/mermaid-trace?style=flat-square)](LICENSE)
-[![CI Status](https://img.shields.io/github/actions/workflow/status/xt765/mermaid-trace/ci.yml?style=flat-square&label=CI)](https://github.com/xt765/mermaid-trace/actions/workflows/ci.yml)
-[![Codecov](https://img.shields.io/codecov/c/github/xt765/mermaid-trace?style=flat-square&logo=codecov)](https://codecov.io/gh/xt765/mermaid-trace)
-
----
-
-## 📋 Overview
-
-**Stop reading logs. Start watching them.**
-
-MermaidTrace is a specialized logging tool that automatically generates [Mermaid JS](https://mermaid.js.org/) sequence diagrams from your code execution. It's perfect for visualizing complex business logic, microservice interactions, or asynchronous flows.
-
----
-
-## 📚 Documentation
-
-### Core Documentation
-
-[User Guide](docs/en/USER_GUIDE.md) · [API Reference](docs/en/API.md) · [Contributing Guidelines](docs/en/CONTRIBUTING.md) · [Changelog](docs/en/CHANGELOG.md) · [License](docs/en/LICENSE)
-
-### Code Comment Documents (Chinese)
-
-| Category | Links |
-| :--- | :--- |
-| **Core Modules** | [Context](docs/zh/code_comments/src/mermaid_trace/core/context.md) · [Decorators](docs/zh/code_comments/src/mermaid_trace/core/decorators.md) · [Events](docs/zh/code_comments/src/mermaid_trace/core/events.md) · [Formatter](docs/zh/code_comments/src/mermaid_trace/core/formatter.md) |
-| **Handlers** | [Async Handler](docs/zh/code_comments/src/mermaid_trace/handlers/async_handler.md) · [Mermaid Handler](docs/zh/code_comments/src/mermaid_trace/handlers/mermaid_handler.md) |
-| **Integrations** | [FastAPI](docs/zh/code_comments/src/mermaid_trace/integrations/fastapi.md) |
-| **Others** | [init](docs/zh/code_comments/src/mermaid_trace/__init__.md) · [CLI](docs/zh/code_comments/src/mermaid_trace/cli.md) |
-
----
-
-## ✨ Key Features
-
-- **Decorator-Driven**: Just add `@trace` or `@trace_interaction` to your functions.
-- **Auto-Instrumentation**: Use `@trace_class` to trace a whole class at once.
-- **Third-Party Patching**: Use `patch_object` to trace calls inside external libraries.
-- **Auto-Diagramming**: Generates `.mmd` files that can be viewed in VS Code, GitHub, or Mermaid Live Editor.
-- **Async Support**: Works seamlessly with `asyncio` coroutines.
-- **Context Inference**: Automatically tracks nested calls and infers `source` participants using `contextvars`.
-- **Intelligent Collapsing**: Prevents diagram explosion by collapsing repetitive high-frequency calls and identifying recurring patterns (e.g., loops).
-- **Detailed Exceptions**: Captures full stack traces for errors, displayed in interactive notes.
-- **Simplified Objects**: Automatically cleans up memory addresses (e.g., `<__main__.Obj at 0x...>` -> `<Obj>`) and **groups consecutive identical items** in lists/tuples (e.g., `[<Obj> x 5]`) for cleaner diagrams.
-- **Log Rotation**: Supports `RotatingMermaidFileHandler` for handling long-running systems by splitting logs based on size or time.
-- **FastAPI Integration**: Includes middleware for zero-config HTTP request tracing, supporting distributed tracing via `X-Trace-ID` and `X-Source` headers.
-- **CLI Tool**: Built-in viewer with live-reload to preview diagrams in your browser.
-
----
-
-## 🚀 Quick Start
-
-### Installation
-
-```bash
-pip install mermaid-trace
-```
-
-### Basic Usage
-
-```python
-from mermaid_trace import trace, configure_flow
-import time
-
-# 1. Configure output
-# Recommendation: Store diagrams in a dedicated directory (e.g., mermaid_diagrams/)
-configure_flow("mermaid_diagrams/my_flow.mmd", async_mode=True)
-
-# 2. Add decorators
-@trace(source="Client", target="PaymentService", action="Process Payment")
-def process_payment(amount):
-    if check_balance(amount):
-        return "Success"
-    return "Failed"
-
-@trace(source="PaymentService", target="Database", action="Check Balance")
-def check_balance(amount):
-    return True
-
-# 3. Run your code
-process_payment(100)
-```
-
-### Configuration
-
-You can configure global settings via `configure_flow` or environment variables to control performance and behavior.
-
-```python
-configure_flow(
-    "flow.mmd", 
-    overwrite=True,    # Overwrite the file on each restart (default: True)
-    level=logging.DEBUG, 
-    queue_size=5000,  # Increase buffer for high-throughput
-    config_overrides={
-        "capture_args": False,       # Disable arg capturing for max performance
-        "max_string_length": 100     # Increase string truncation limit
-    }
-)
-```
-
-**Environment Variables:**
-- `MERMAID_TRACE_CAPTURE_ARGS` (true/false)
-- `MERMAID_TRACE_MAX_STRING_LENGTH` (int)
-- `MERMAID_TRACE_MAX_ARG_DEPTH` (int)
-- `MERMAID_TRACE_QUEUE_SIZE` (int)
-
-### Nested Calls (Context Inference)
-
-You don't need to specify `source` every time. MermaidTrace infers it from the current context.
-
-```python
-@trace(source="Client", target="API")
-def main():
-    # Inside here, current participant is "API"
-    service_call()
-
-@trace(target="Service") # source inferred as "API"
-def service_call():
-    pass
-```
-
-### FastAPI Integration
-
-```python
-from fastapi import FastAPI
-from mermaid_trace.integrations.fastapi import MermaidTraceMiddleware
-
-app = FastAPI()
-app.add_middleware(MermaidTraceMiddleware, app_name="MyAPI")
-
-@app.get("/")
-async def root():
-    return {"message": "Hello World"}
-```
-
-### CLI Viewer
-
-Visualize your generated `.mmd` files instantly:
-
-```bash
-mermaid-trace serve my_flow.mmd
-```
-
-### Examples
-
-Check out the [examples/](examples/) directory for a complete set of demos covering all features:
-- **[Basic Usage](examples/01_basic_usage.py)**: Decorators and class methods.
-- **[Advanced Instrumentation](examples/02_advanced_instrumentation.py)**: `@trace_class` and `patch_object` for third-party libraries.
-- **[Async & Concurrency](examples/03_async_concurrency.py)**: Tracing `asyncio` and concurrent tasks.
-- **[Error Handling](examples/04_error_handling.py)**: Stack trace capture and error rendering.
-- **[Intelligent Collapsing](examples/05_intelligent_collapsing.py)**: Keeping diagrams clean in loops.
-- **[FastAPI Integration](examples/06_fastapi_integration.py)**: Middleware for web apps.
-- **[Full Stack App](examples/07_full_stack_app.py)**: Comprehensive example with FastAPI, SQLAlchemy, and Pydantic.
-- **[Log Rotation](examples/08-log-rotation.py)**: Handling long-running processes with file rotation.
-
----
-
-## 🤝 Contributing
-
-We welcome contributions! Please see [CONTRIBUTING.md](docs/en/CONTRIBUTING.md) for details.
-
----
-
-## 📄 License
-
-MIT