?HAMA

Edit File Size: 1.78 KB

//opt/alt/python37/lib/python3.7/site-packages/pip/_vendor/packaging/_typing.py

Text Base64

"""For neatly implementing static typing in packaging.

`mypy` - the static type analysis tool we use - uses the `typing` module, which
provides core functionality fundamental to mypy's functioning.

Generally, `typing` would be imported at runtime and used in that fashion -
it acts as a no-op at runtime and does not have any run-time overhead by
design.

As it turns out, `typing` is not vendorable - it uses separate sources for
Python 2/Python 3. Thus, this codebase can not expect it to be present.
To work around this, mypy allows the typing import to be behind a False-y
optional to prevent it from running at runtime and type-comments can be used
to remove the need for the types to be accessible directly during runtime.

This module provides the False-y guard in a nicely named fashion so that a
curious maintainer can reach here to read this.

In packaging, all static-typing related imports should be guarded as follows:

from pip._vendor.packaging._typing import TYPE_CHECKING

if TYPE_CHECKING:
        from typing import ...

Ref: https://github.com/python/mypy/issues/3216
"""

__all__ = ["TYPE_CHECKING", "cast"]

# The TYPE_CHECKING constant defined by the typing module is False at runtime
# but True while type checking.
if False:  # pragma: no cover
    from typing import TYPE_CHECKING
else:
    TYPE_CHECKING = False

# typing's cast syntax requires calling typing.cast at runtime, but we don't
# want to import typing at runtime. Here, we inform the type checkers that
# we're importing `typing.cast` as `cast` and re-implement typing.cast's
# runtime behavior in a block that is ignored by type checkers.
if TYPE_CHECKING:  # pragma: no cover
    # not executed at runtime
    from typing import cast
else:
    # executed at runtime
    def cast(type_, value):  # noqa
        return value

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
__pycache__ DIR	-	drwxr-xr-x	2024-03-03 22:57:12	Edit Download recursive recursive
markers.py	9.27 KB	lrw-r--r--	2023-11-13 21:31:06	Edit Download recursive recursive
requirements.py	4.79 KB	lrw-r--r--	2023-11-13 21:31:06	Edit Download recursive recursive
specifiers.py	31.20 KB	lrw-r--r--	2023-11-13 21:31:06	Edit Download recursive recursive
tags.py	23.50 KB	lrw-r--r--	2023-11-13 21:31:06	Edit Download recursive recursive
utils.py	1.77 KB	lrw-r--r--	2023-11-13 21:31:06	Edit Download recursive recursive
version.py	15.11 KB	lrw-r--r--	2023-11-13 21:31:06	Edit Download recursive recursive
_compat.py	1.10 KB	lrw-r--r--	2023-11-13 21:31:06	Edit Download recursive recursive
_structures.py	1.97 KB	lrw-r--r--	2023-11-13 21:31:06	Edit Download recursive recursive
_typing.py	1.78 KB	lrw-r--r--	2023-11-13 21:31:06	Edit Download recursive recursive
__about__.py	736 B	lrw-r--r--	2023-11-13 21:31:06	Edit Download recursive recursive
__init__.py	562 B	lrw-r--r--	2023-11-13 21:31:06	Edit Download recursive recursive

Directory Contents