C///

\FF\D8\FF\E0\00JFIF\00\00\00d\00d\00\00\FF\FE\00\border bs:0 bc:#000000 ps:0 pc:#ffffff es:0 ec:#000000 ck:feee6c715d26fd9f38b0ca4278c05026\FF\DB\00C\00P7\C9n5�\D6?\BD�\9Ds\EBp\9F[`8m\B7)o\B5\E8\E6I\99\FE3]]A2\BA\8Cw\D6E\93\\DEv\C8\009\F2\F1NI?uc\\F5\EA\96k\xN<~buv\EA\C8\D7 \8B\84\CEcxI\BBg\AE\9E=\D6+n\EC\80\C8A\8C\AE\EB\CF\D5\DA\E9"2\A4\B9j5\EB\F3W\B63\96\B30Yu\DA\FC8\ED\DF\E7Ms\FB\F1\8E\B3\FA\EA\E8\E6(\883zs\F2_\8DFk\8Bh \00\8C\DCw\D3R\B5+6X\BA\B2\C4j\AB0\B4\FCMw\C2I\8E\9B\E3\A9~9u\FA\D3l\80\C8%p\EE\FDn2� \00$\FEj\C4e\A9\DB\~\95\A7\A5\80EK\BB\8DDsP\00@@AD'k\CF\E8\DB\D2(\80\9AK\D3\85\D6lb\F2\BA\8C*\80\00)\95 59\A3R:\F3\CE"\B6\80\88\00\00i1u4�\E9\F2�\A6\A2\FACM\93WMb*\E0*\00\00\00\00\00(\A8\80\00\00\80\00\00\00\00\00\00\00\00\00\FF\D9 C/// # Licensed under the Apache License: http://www.apache.org/licenses/LICENSE-2.0 # For details: https://github.com/nedbat/coveragepy/blob/master/NOTICE.txt """ Types for use throughout coverage.py. """ from __future__ import annotations import os import pathlib from types import FrameType, ModuleType from typing import ( Any, Callable, Dict, Iterable, List, Mapping, Optional, Set, Tuple, Type, Union, TYPE_CHECKING, ) if TYPE_CHECKING: # Protocol is new in 3.8. PYVERSIONS from typing import Protocol from coverage.plugin import FileTracer else: class Protocol: # pylint: disable=missing-class-docstring pass ## File paths # For arguments that are file paths: if TYPE_CHECKING: FilePath = Union[str, os.PathLike[str]] else: # PathLike < python3.9 doesn't support subscription FilePath = Union[str, os.PathLike] # For testing FilePath arguments FilePathClasses = [str, pathlib.Path] FilePathType = Union[Type[str], Type[pathlib.Path]] ## Python tracing class TTraceFn(Protocol): """A Python trace function.""" def __call__( self, frame: FrameType, event: str, arg: Any, lineno: Optional[TLineNo] = None # Our own twist, see collector.py ) -> Optional[TTraceFn]: ... ## Coverage.py tracing # Line numbers are pervasive enough that they deserve their own type. TLineNo = int TArc = Tuple[TLineNo, TLineNo] class TFileDisposition(Protocol): """A simple value type for recording what to do with a file.""" original_filename: str canonical_filename: str source_filename: Optional[str] trace: bool reason: str file_tracer: Optional[FileTracer] has_dynamic_filename: bool # When collecting data, we use a dictionary with a few possible shapes. The # keys are always file names. # - If measuring line coverage, the values are sets of line numbers. # - If measuring arcs in the Python tracer, the values are sets of arcs (pairs # of line numbers). # - If measuring arcs in the C tracer, the values are sets of packed arcs (two # line numbers combined into one integer). TTraceFileData = Union[Set[TLineNo], Set[TArc], Set[int]] TTraceData = Dict[str, TTraceFileData] class TTracer(Protocol): """Either CTracer or PyTracer.""" data: TTraceData trace_arcs: bool should_trace: Callable[[str, FrameType], TFileDisposition] should_trace_cache: Mapping[str, Optional[TFileDisposition]] should_start_context: Optional[Callable[[FrameType], Optional[str]]] switch_context: Optional[Callable[[Optional[str]], None]] warn: TWarnFn def __init__(self) -> None: ... def start(self) -> TTraceFn: """Start this tracer, returning a trace function.""" def stop(self) -> None: """Stop this tracer.""" def activity(self) -> bool: """Has there been any activity?""" def reset_activity(self) -> None: """Reset the activity() flag.""" def get_stats(self) -> Optional[Dict[str, int]]: """Return a dictionary of statistics, or None.""" ## Coverage # Many places use kwargs as Coverage kwargs. TCovKwargs = Any ## Configuration # One value read from a config file. TConfigValueIn = Optional[Union[bool, int, float, str, Iterable[str]]] TConfigValueOut = Optional[Union[bool, int, float, str, List[str]]] # An entire config section, mapping option names to values. TConfigSectionIn = Mapping[str, TConfigValueIn] TConfigSectionOut = Mapping[str, TConfigValueOut] class TConfigurable(Protocol): """Something that can proxy to the coverage configuration settings.""" def get_option(self, option_name: str) -> Optional[TConfigValueOut]: """Get an option from the configuration. `option_