Files
pytorch/torch/_C/_dynamo/eval_frame.pyi
Lucas Kabela 40c4d61f9a [Dynamo][Better Engineering] Typing torch/_dynamo/guards.py (#159315)
As part of better engineering effort, we would like to improve out type support to improve dev experience in dynamo

This PR adds strict typing support to `torch/_dynamo/guards.py`

Running
```
mypy torch/_dynamo/guards.py --linecount-report /tmp/coverage_log
```

| -------- | Lines Annotated | Lines Total | % lines covered | Funcs Annotated | Funcs Total | % funcs covered |
| -------- | ------- | -------- | ------- | ------- | ------- | ------- |
| Main  |  2030 | 3945 | 51.46% | 70 | 138 | 50.72% |
| This PR | 4055 | 4055 | 100.00% | 138 | 138 | 100.00% |
| Delta    | +2025 | +90 | +48.54% | +68 | 0 | +49.28% |

Pull Request resolved: https://github.com/pytorch/pytorch/pull/159315
Approved by: https://github.com/williamwen42, https://github.com/Skylion007
2025-08-06 21:52:14 +00:00

81 lines
2.5 KiB
Python

import enum
import types
from typing import Optional, overload
from torch._dynamo.guards import GuardManagerWrapper
from torch._dynamo.types import DynamoCallback, DynamoGuardCompleteHook, DynamoGuardHook
from torch._guards import CompileId
def set_eval_frame(callback: DynamoCallback) -> DynamoCallback: ...
def set_skip_guard_eval_unsafe(value: bool) -> bool: ...
def get_eval_frame_callback() -> DynamoCallback: ...
def reset_code(code: types.CodeType) -> None: ...
def unsupported(obj1: object, obj2: object) -> object: ...
def set_code_exec_strategy(
code: types.CodeType, strategy: _FrameExecStrategy
) -> None: ...
def set_guard_error_hook(hook: DynamoGuardHook) -> None: ...
def set_guard_complete_hook(
hook: Optional[DynamoGuardCompleteHook],
) -> Optional[DynamoGuardCompleteHook]: ...
def raise_sigtrap() -> None: ...
class _CacheEntry:
def check_fn(self, *args: object, **kwargs: object) -> bool: ...
def update_diff_guard_root_manager(self) -> None: ...
code: types.CodeType
compile_id: CompileId
# If we run into circular issues, just use object
guard_manager: GuardManagerWrapper
next: _CacheEntry | None
class _PrecompileEntry:
guard_manager: GuardManagerWrapper
class _ExtraState:
def invalidate(
self, cache_entry: _CacheEntry, guard_manager: GuardManagerWrapper
) -> None: ...
class _FrameAction(enum.IntEnum):
DEFAULT = 0
SKIP = 1
RUN_ONLY = 2
class _FrameExecStrategy:
cur_action: _FrameAction
recursive_action: _FrameAction
@overload
def __init__(self) -> None: ...
@overload
def __init__(
self, cur_action: _FrameAction, recursive_action: _FrameAction
) -> None: ...
# This is an object that encapsulates the Python FrameType, and exposes
# properties Dynamo cares about for a frame.
class _PyInterpreterFrame:
f_code: types.CodeType
f_locals: dict[str, object]
f_globals: dict[str, object]
f_builtins: dict[str, object]
f_lasti: int
f_lineno: int
f_back: types.FrameType
# A tuple containing cell objects captured by this frame.
closure: tuple[types.CellType]
def _debug_get_cache_entry_list(code: types.CodeType) -> list[_CacheEntry]: ...
py_opcode_caches: list[int]
def code_framelocals_names(code: types.CodeType) -> tuple[str]: ...
def _load_precompile_entry(
code: types.CodeType,
guard_manager: GuardManagerWrapper,
dynamo_code: types.CodeType,
) -> None: ...
def _reset_precompile_entries(code: types.CodeType) -> None: ...
def _debug_get_precompile_entries(code: types.CodeType) -> list[_PrecompileEntry]: ...