ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: opt / alt / python27 / lib / python2.7 / site-packages / pip / _internal / utils

"""For neatly implementing static typing in pip.

`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 pip, all static-typing related imports should be guarded as follows:

from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
        from typing import ...

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

MYPY_CHECK_RUNNING = False

if MYPY_CHECK_RUNNING:
    from typing import cast
else:
    # typing's cast() is needed at runtime, but we don't want to import typing.
    # Thus, we use a dummy no-op version, which we tell mypy to ignore.
    def cast(type_, value):  # type: ignore
        return value

[-] typing.py [edit]
[-] compat.py [edit]
[-] logging.pyc [edit]
[-] setuptools_build.py [edit]
[-] subprocess.py [edit]
[-] models.pyc [edit]
[-] entrypoints.pyc [edit]
[-] glibc.pyc [edit]
[-] compat.pyc [edit]
[-] datetime.pyc [edit]
[-] temp_dir.py [edit]
[-] misc.pyc [edit]
[-] deprecation.pyc [edit]
[-] filesystem.py [edit]
[-] entrypoints.py [edit]
[-] __init__.py [edit]
[-] glibc.py [edit]
[-] encoding.pyc [edit]
[-] wheel.py [edit]
[-] parallel.py [edit]
[-] filesystem.pyc [edit]
[-] encoding.py [edit]
[-] virtualenv.pyc [edit]
[+] ..
[-] typing.pyc [edit]
[-] virtualenv.py [edit]
[-] packaging.pyc [edit]
[-] appdirs.py [edit]
[-] misc.py [edit]
[-] pkg_resources.pyc [edit]
[-] subprocess.pyc [edit]
[-] temp_dir.pyc [edit]
[-] hashes.pyc [edit]
[-] appdirs.pyc [edit]
[-] hashes.py [edit]
[-] packaging.py [edit]
[-] compatibility_tags.py [edit]
[-] filetypes.py [edit]
[-] deprecation.py [edit]
[-] urls.pyc [edit]
[-] distutils_args.py [edit]
[-] wheel.pyc [edit]
[-] filetypes.pyc [edit]
[-] setuptools_build.pyc [edit]
[-] unpacking.pyc [edit]
[-] unpacking.py [edit]
[-] urls.py [edit]
[-] datetime.py [edit]
[-] pkg_resources.py [edit]
[-] models.py [edit]
[-] inject_securetransport.pyc [edit]
[-] compatibility_tags.pyc [edit]
[-] __init__.pyc [edit]
[-] parallel.pyc [edit]
[-] direct_url_helpers.py [edit]
[-] logging.py [edit]
[-] direct_url_helpers.pyc [edit]
[-] inject_securetransport.py [edit]
[-] distutils_args.pyc [edit]