mirror of
https://github.com/pytorch/pytorch.git
synced 2025-10-20 21:14:14 +08:00
21c2565f35
Many files in dynamo are currently lacking file/module-level documentation, which makes it hard to know what they do at a glance and without digging into the code. This fixes that. Note: documentation was AI-generated and could be incorrect, please review carefully. Pull Request resolved: https://github.com/pytorch/pytorch/pull/146736 Approved by: https://github.com/jansel, https://github.com/StrongerXi, https://github.com/anijain2305, https://github.com/zou3519
43 lines
1.4 KiB
Python
43 lines
1.4 KiB
Python
"""
|
|
Provides thread-local scope identification for SubgraphTracer instances.
|
|
|
|
This module implements a thread-safe mechanism for tracking nested tracing contexts,
|
|
which is essential when multiple SubgraphTracer instances are active. The scope ID
|
|
helps identify which tracer context is currently active when direct access to the
|
|
InstructionTranslator is difficult.
|
|
|
|
Key components:
|
|
- Thread-local scope ID storage (_current_scope_id)
|
|
- Getter function (current_scope_id) to safely access the current scope
|
|
- Context manager (enter_new_scope) for managing nested scope transitions
|
|
|
|
The scope ID increments when entering a new context and decrements when exiting,
|
|
allowing proper tracking of nested tracing operations across different threads.
|
|
"""
|
|
|
|
import contextlib
|
|
import threading
|
|
from collections.abc import Generator
|
|
|
|
|
|
# Global variable to identify which SubgraphTracer we are in.
|
|
# It is sometimes difficult to find an InstructionTranslator to use.
|
|
_current_scope_id = threading.local()
|
|
|
|
|
|
def current_scope_id() -> int:
|
|
global _current_scope_id
|
|
if not hasattr(_current_scope_id, "value"):
|
|
_current_scope_id.value = 1
|
|
return _current_scope_id.value
|
|
|
|
|
|
@contextlib.contextmanager
|
|
def enter_new_scope() -> Generator[None, None, None]:
|
|
global _current_scope_id
|
|
try:
|
|
_current_scope_id.value = current_scope_id() + 1
|
|
yield
|
|
finally:
|
|
_current_scope_id.value = current_scope_id() - 1
|