from __future__ import absolute_import import hashlib from pip._vendor.six import iteritems, iterkeys, itervalues from pip._internal.exceptions import ( HashMismatch, HashMissing, InstallationError, ) from pip._internal.utils.misc import read_chunks from pip._internal.utils.typing import MYPY_CHECK_RUNNING if MYPY_CHECK_RUNNING: from typing import ( Dict, List, BinaryIO, NoReturn, Iterator ) from pip._vendor.six import PY3 if PY3: from hashlib import _Hash else: from hashlib import _hash as _Hash # The recommended hash algo of the moment. Change this whenever the state of # the art changes; it won't hurt backward compatibility. FAVORITE_HASH = 'sha256' # Names of hashlib algorithms allowed by the --hash option and ``pip hash`` # Currently, those are the ones at least as collision-resistant as sha256. STRONG_HASHES = ['sha256', 'sha384', 'sha512'] class Hashes(object): """A wrapper that builds multiple hashes at once and checks them against known-good values """ def __init__(self, hashes=None): # type: (Dict[str, List[str]]) -> None """ :param hashes: A dict of algorithm names pointing to lists of allowed hex digests """ self._allowed = {} if hashes is None else hashes def __and__(self, other): # type: (Hashes) -> Hashes if not isinstance(other, Hashes): return NotImplemented # If either of the Hashes object is entirely empty (i.e. no hash # specified at all), all hashes from the other object are allowed. if not other: return self if not self: return other # Otherwise only hashes that present in both objects are allowed. new = {} for alg, values in iteritems(other._allowed): if alg not in self._allowed: continue new[alg] = [v for v in values if v in self._allowed[alg]] return Hashes(new) @property def digest_count(self): # type: () -> int return sum(len(digests) for digests in self._allowed.values()) def is_hash_allowed( self, hash_name, # type: str hex_digest, # type: str ): # type: (...) -> bool """Return whether the given hex digest is allowed.""" return hex_digest in self._allowed.get(hash_name, []) def check_against_chunks(self, chunks): # type: (Iterator[bytes]) -> None """Check good hashes against ones built from iterable of chunks of data. Raise HashMismatch if none match. """ gots = {} for hash_name in iterkeys(self._allowed): try: gots[hash_name] = hashlib.new(hash_name) except (ValueError, TypeError): raise InstallationError( 'Unknown hash name: {}'.format(hash_name) ) for chunk in chunks: for hash in itervalues(gots): hash.update(chunk) for hash_name, got in iteritems(gots): if got.hexdigest() in self._allowed[hash_name]: return self._raise(gots) def _raise(self, gots): # type: (Dict[str, _Hash]) -> NoReturn raise HashMismatch(self._allowed, gots) def check_against_file(self, file): # type: (BinaryIO) -> None """Check good hashes against a file-like object Raise HashMismatch if none match. """ return self.check_against_chunks(read_chunks(file)) def check_against_path(self, path): # type: (str) -> None with open(path, 'rb') as file: return self.check_against_file(file) def __nonzero__(self): # type: () -> bool """Return whether I know any known-good hashes.""" return bool(self._allowed) def __bool__(self): # type: () -> bool return self.__nonzero__() class MissingHashes(Hashes): """A workalike for Hashes used when we're missing a hash for a requirement It computes the actual hash of the requirement and raises a HashMissing exception showing it to the user. """ def __init__(self): # type: () -> None """Don't offer the ``hashes`` kwarg.""" # Pass our favorite hash in to generate a "gotten hash". With the # empty list, it will never match, so an error will always raise. super(MissingHashes, self).__init__(hashes={FAVORITE_HASH: []}) def _raise(self, gots): # type: (Dict[str, _Hash]) -> NoReturn raise HashMissing(gots[FAVORITE_HASH].hexdigest())
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
__pycache__ | Folder | 0755 |
|
|
.__init__.pyo.40009 | File | 164 B | 0644 |
|
.appdirs.pyo.40009 | File | 1.78 KB | 0644 |
|
.compat.pyo.40009 | File | 8.62 KB | 0644 |
|
.compatibility_tags.pyo.40009 | File | 4.45 KB | 0644 |
|
.datetime.pyo.40009 | File | 625 B | 0644 |
|
.deprecation.pyo.40009 | File | 3.44 KB | 0644 |
|
.distutils_args.pyo.40009 | File | 1.6 KB | 0644 |
|
.entrypoints.pyo.40009 | File | 1.47 KB | 0644 |
|
.filetypes.pyo.40009 | File | 792 B | 0644 |
|
.glibc.pyo.40009 | File | 2.19 KB | 0644 |
|
.hashes.pyo.40009 | File | 5.68 KB | 0644 |
|
.inject_securetransport.pyo.40009 | File | 1.07 KB | 0644 |
|
.logging.pyo.40009 | File | 11.6 KB | 0644 |
|
.misc.pyo.40009 | File | 32.2 KB | 0644 |
|
.models.pyo.40009 | File | 2.55 KB | 0644 |
|
.packaging.pyo.40009 | File | 3.27 KB | 0644 |
|
.parallel.pyo.40009 | File | 3.62 KB | 0644 |
|
.pkg_resources.pyo.40009 | File | 2.39 KB | 0644 |
|
.typing.pyo.40009 | File | 1.52 KB | 0644 |
|
.virtualenv.pyo.40009 | File | 4.11 KB | 0644 |
|
.wheel.pyo.40009 | File | 7.27 KB | 0644 |
|
__init__.py | File | 0 B | 0644 |
|
__init__.pyc | File | 164 B | 0644 |
|
__init__.pyo | File | 164 B | 0644 |
|
appdirs.py | File | 1.32 KB | 0644 |
|
appdirs.pyc | File | 1.78 KB | 0644 |
|
appdirs.pyo | File | 1.78 KB | 0644 |
|
compat.py | File | 9.27 KB | 0644 |
|
compat.pyc | File | 8.62 KB | 0644 |
|
compat.pyo | File | 8.62 KB | 0644 |
|
compatibility_tags.py | File | 5.31 KB | 0644 |
|
compatibility_tags.pyc | File | 4.45 KB | 0644 |
|
compatibility_tags.pyo | File | 4.45 KB | 0644 |
|
datetime.py | File | 295 B | 0644 |
|
datetime.pyc | File | 625 B | 0644 |
|
datetime.pyo | File | 625 B | 0644 |
|
deprecation.py | File | 3.24 KB | 0644 |
|
deprecation.pyc | File | 3.44 KB | 0644 |
|
deprecation.pyo | File | 3.44 KB | 0644 |
|
direct_url_helpers.py | File | 4.26 KB | 0644 |
|
direct_url_helpers.pyc | File | 3.37 KB | 0644 |
|
direct_url_helpers.pyo | File | 3.24 KB | 0644 |
|
distutils_args.py | File | 1.32 KB | 0644 |
|
distutils_args.pyc | File | 1.6 KB | 0644 |
|
distutils_args.pyo | File | 1.6 KB | 0644 |
|
encoding.py | File | 1.25 KB | 0644 |
|
encoding.pyc | File | 1.61 KB | 0644 |
|
encoding.pyo | File | 1.56 KB | 0644 |
|
entrypoints.py | File | 1.19 KB | 0644 |
|
entrypoints.pyc | File | 1.47 KB | 0644 |
|
entrypoints.pyo | File | 1.47 KB | 0644 |
|
filesystem.py | File | 6.78 KB | 0644 |
|
filesystem.pyc | File | 7.4 KB | 0644 |
|
filesystem.pyo | File | 7.35 KB | 0644 |
|
filetypes.py | File | 571 B | 0644 |
|
filetypes.pyc | File | 792 B | 0644 |
|
filetypes.pyo | File | 792 B | 0644 |
|
glibc.py | File | 3.22 KB | 0644 |
|
glibc.pyc | File | 2.19 KB | 0644 |
|
glibc.pyo | File | 2.19 KB | 0644 |
|
hashes.py | File | 4.57 KB | 0644 |
|
hashes.pyc | File | 5.68 KB | 0644 |
|
hashes.pyo | File | 5.68 KB | 0644 |
|
inject_securetransport.py | File | 810 B | 0644 |
|
inject_securetransport.pyc | File | 1.07 KB | 0644 |
|
inject_securetransport.pyo | File | 1.07 KB | 0644 |
|
logging.py | File | 12.79 KB | 0644 |
|
logging.pyc | File | 11.6 KB | 0644 |
|
logging.pyo | File | 11.6 KB | 0644 |
|
misc.py | File | 27.67 KB | 0644 |
|
misc.pyc | File | 32.2 KB | 0644 |
|
misc.pyo | File | 32.2 KB | 0644 |
|
models.py | File | 1.17 KB | 0644 |
|
models.pyc | File | 2.55 KB | 0644 |
|
models.pyo | File | 2.55 KB | 0644 |
|
packaging.py | File | 2.96 KB | 0644 |
|
packaging.pyc | File | 3.27 KB | 0644 |
|
packaging.pyo | File | 3.27 KB | 0644 |
|
parallel.py | File | 3.32 KB | 0644 |
|
parallel.pyc | File | 3.62 KB | 0644 |
|
parallel.pyo | File | 3.62 KB | 0644 |
|
pkg_resources.py | File | 1.22 KB | 0644 |
|
pkg_resources.pyc | File | 2.39 KB | 0644 |
|
pkg_resources.pyo | File | 2.39 KB | 0644 |
|
setuptools_build.py | File | 4.94 KB | 0644 |
|
setuptools_build.pyc | File | 3.83 KB | 0644 |
|
setuptools_build.pyo | File | 3.75 KB | 0644 |
|
subprocess.py | File | 9.69 KB | 0644 |
|
subprocess.pyc | File | 6.77 KB | 0644 |
|
subprocess.pyo | File | 6.69 KB | 0644 |
|
temp_dir.py | File | 8.18 KB | 0644 |
|
temp_dir.pyc | File | 8.75 KB | 0644 |
|
temp_dir.pyo | File | 8.62 KB | 0644 |
|
typing.py | File | 1.37 KB | 0644 |
|
typing.pyc | File | 1.52 KB | 0644 |
|
typing.pyo | File | 1.52 KB | 0644 |
|
unpacking.py | File | 9.27 KB | 0644 |
|
unpacking.pyc | File | 7.83 KB | 0644 |
|
unpacking.pyo | File | 7.79 KB | 0644 |
|
urls.py | File | 1.49 KB | 0644 |
|
urls.pyc | File | 1.94 KB | 0644 |
|
urls.pyo | File | 1.8 KB | 0644 |
|
virtualenv.py | File | 3.62 KB | 0644 |
|
virtualenv.pyc | File | 4.11 KB | 0644 |
|
virtualenv.pyo | File | 4.11 KB | 0644 |
|
wheel.py | File | 7.13 KB | 0644 |
|
wheel.pyc | File | 7.27 KB | 0644 |
|
wheel.pyo | File | 7.27 KB | 0644 |
|