File Manager

X7ROOT File Manager

Current Path: /opt/cloudlinux/venv/lib/python3.11/site-packages/coverage

opt / cloudlinux / venv / lib / python3.11 / site-packages / coverage /

?? ..
?? __init__.py(1.25 KB)
?? __main__.py(257 B)
?? __pycache__
?? annotate.py(3.67 KB)
?? bytecode.py(713 B)
?? cmdline.py(33.62 KB)
?? collector.py(20.08 KB)
?? config.py(21.47 KB)
?? context.py(2.42 KB)
?? control.py(50.49 KB)
?? data.py(7.33 KB)
?? debug.py(17.39 KB)
?? disposition.py(1.87 KB)
?? env.py(5.94 KB)
?? exceptions.py(1.33 KB)
?? execfile.py(11.85 KB)
?? files.py(18.92 KB)
?? fullcoverage
?? html.py(22.62 KB)
?? htmlfiles
?? inorout.py(23.34 KB)
?? jsonreport.py(4.64 KB)
?? lcovreport.py(4.82 KB)
?? misc.py(11.89 KB)
?? multiproc.py(3.76 KB)
?? numbits.py(4.56 KB)
?? parser.py(55.39 KB)
?? phystokens.py(7.62 KB)
?? plugin.py(19.07 KB)
?? plugin_support.py(10.11 KB)
?? py.typed(72 B)
?? python.py(7.88 KB)
?? pytracer.py(14.08 KB)
?? report.py(10.37 KB)
?? report_core.py(3.97 KB)
?? results.py(13.07 KB)
?? sqldata.py(50.09 KB)
?? templite.py(10.7 KB)
?? tomlconfig.py(7.39 KB)
?? tracer.cpython-311-x86_64-linux-gnu.so(28.77 KB)
?? types.py(5.4 KB)
?? version.py(1.4 KB)
?? xmlreport.py(9.57 KB)

Editing: types.py

# 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_name` is a colon-separated string indicating the section and
        option name.  For example, the ``branch`` option in the ``[run]``
        section of the config file would be indicated with `"run:branch"`.

Returns the value of the option.

"""

def set_option(self, option_name: str, value: Union[TConfigValueIn, TConfigSectionIn]) -> None:
        """Set an option in the configuration.

`value` is the new value for the option.

"""

class TPluginConfig(Protocol):
    """Something that can provide options to a plugin."""

def get_plugin_options(self, plugin: str) -> TConfigSectionOut:
        """Get the options for a plugin."""

## Parsing

TMorf = Union[ModuleType, str]

TSourceTokenLines = Iterable[List[Tuple[str, str]]]

## Plugins

class TPlugin(Protocol):
    """What all plugins have in common."""
    _coverage_plugin_name: str
    _coverage_enabled: bool

## Debugging

class TWarnFn(Protocol):
    """A callable warn() function."""
    def __call__(self, msg: str, slug: Optional[str] = None, once: bool = False) -> None:
        ...

class TDebugCtl(Protocol):
    """A DebugControl object, or something like it."""

def should(self, option: str) -> bool:
        """Decide whether to output debug information in category `option`."""

def write(self, msg: str) -> None:
        """Write a line of debug output."""

class TWritable(Protocol):
    """Anything that can be written to."""

def write(self, msg: str) -> None:
        """Write a message."""

X7ROOT File Manager

Editing: types.py

Upload File

Create Folder