././@PaxHeader 0000000 0000000 0000000 00000000034 00000000000 010212 x ustar 00 28 mtime=1781251341.5235376
distlib-0.4.3/ 0000775 0001750 0001750 00000000000 15212736416 012257 5 ustar 00vinay vinay ././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1781250942.0
distlib-0.4.3/CHANGES.rst 0000664 0001750 0001750 00000070426 15212735576 014100 0 ustar 00vinay vinay Change log for ``distlib``
--------------------------
0.4.4 (future)
~~~~~~~~~~~~~~
Released: Not yet.
0.4.3
~~~~~
Released: Not yet.
- resources
- Removed too-restrictive check for escaping resources.
0.4.2
~~~~~
Released: 2026-06-08
- locators
- Fix URL percent-encoding using space-padding instead of zero-padding. Thanks to
Kadir Can Ozden for the patch.
- Harden decompression against malicious input. Thanks to tonghuaroot for the patch,
which was adapted slightly.
- manifest
- Use os.lstat in findall to correctly detect symlinked directories. Thanks to
Kadir Can Ozden for the patch.
- metadata
- Improve logic to incorporate newer metadata versions.
- resources
- Ensure that constructed resource paths don't escape the package. Thanks to
tonghuaroot for the patch.
- util
- Fix #255: Update cache_from_source() for Python 3.15. Thanks to Victor Stinner
for the patch.
- Check during unarchiving that the destination directory isn't escaped via symlinks.
Thanks to tonghuaroot for the patch.
- Improved performance of normalize_name using dual replace. Thanks to
Hugo van Kemenade for the patch.
- wheel
- Add checks that installed files don't escape the installation directory. Thanks to
tonghuaroot for the patch.
- Add checks when mounting extensions to ensure path containment. Thanks to
tonghuaroot for the patch.
0.4.1
~~~~~
Released: 2026-06-02
- scripts
- Fix path traversal bug in handling entry points which allowed escaping the scripts directory.
Thanks to tonghuaroot for the comprehensive report.
- tests
- Fix #251: Change test function following a reorganization which happened in the Python stdlib.
0.4.0
~~~~~
Released: 2025-07-17
- markers
- Add the ``interpret_parsed`` function.
- wheel
- Fix #238: Add build tag to wheel metadata if specified.
- Fix #243: Update to support free-threading version of Python (3.13t).
- Fix #246: Support subdirectories in the dist-info directory. Thanks to Pieter P for the patch.
- Fix #248: Fix path normalisation issue caused by the fix for #246.
- Move import in script wrapper to "if __name__ == 'main'" clause.
- tests
- Fix #245: Skip test_package_data if a SKIP_EXT_PACKAGE_DATA environment variable is present.
0.3.9
~~~~~
Released: 2024-10-09
- scripts
- Merge #215: preload script wrappers on Windows to assist with a pip issue (thanks,
Paul Moore).
- Fix #220: Remove duplicated newline in shebang of windows launcher (thanks. A2uria).
- Fix #230: Add handling for cross-compilation environments (thanks, Russell Keith-Magee).
- util
- Fix #224: Do not use the absolute path to cache wheel extensions (thanks, Stewart Miles).
- wheel
- Fix #222: Support mounting wheels that use extensions without an EXTENSIONS file (thanks,
Stewart Miles).
- Fix #225: Add support for wheel compatibility with the limited API (thanks, Stewart Miles).
0.3.8
~~~~~
Released: 2023-12-12
- markers
- Fix #209: use legacy version implementation for Python versions.
- tests
- Fix #204: use symlinks in venv creation during test.
- Fix #208: handle deprecation removals in Python 3.13.
0.3.7
~~~~~
Released: 2023-07-17
- database
- Handle newlines when parsing metadata.
- markers
- Use version comparison logic for python_full_version. Thanks to Albert
Peschar for the patch.
- Simplify code with a set comprehension. Thanks to Christian Clauss for
the patch.
- scripts
- Fix shebang computation for source builds of Python. Thanks to Eli
Schwartz for the patch.
- util
- Extract tarfiles more safely by incorporating tarfile filters. Thanks to
Petr Viktorin for the patch.
- Check for 'has_cert' attribute before using it. Thanks to Lumir Balhar for
the patch.
- Fix #203: Handle parsing of export entries to allow script names such as
"," or ",foo". Thanks to Flavio Amurrio for the report.
- versions
- Fix #200: Improve conformance to PEP440. Thanks to GitHub user con-f-use
for the report.
In addition to the above, an SPDX license identifier is now used.
0.3.6
~~~~~
Released: 2022-08-26
- scripts
- Fixed #175: Updated launcher executables to better handle the relationship
between launcher and child process in the Job API.
0.3.5
~~~~~
Released: 2022-07-14
- database
- Fixed #170: Corrected implementation of ``get_required_dists()``.
- index
- Updated coverage pragmas for tests relating to obsolete PyPI APIs.
- locators
- Changed the default locator configuration.
- metadata
- Updates in support of PEP 643 / Metadata 2.2.
- scripts
- Updated launcher executables. Thanks to Michael Bikovitsky for his help with
the launcher changes.
- Fixed #164: Improved support for reproducible builds by allowing a fixed
date/time to be inserted into created .exe files. Thanks to Somber Night for the
patch.
- util
- Fixed #161: Updated test case.
- wheel
- Updated to write archive path of RECORD to RECORD instead of staging path.
Thanks to Pieter Pas for the patch.
- Fixed #169: Removed usage of deprecated imp module in favour of importlib.
- Fixed #172: Compute ABI correctly for Python < 3.8.
In addition to the above, setup.py was replaced by setup.cfg and pyproject.toml.
0.3.4
~~~~~
Released: 2021-12-08
- database
- Fixed #153: Raise warnings in get_distributions() if bad metadata seen, but keep
going.
- markers
- Fixed #154: Determine Python versions correctly for Python >= 3.10.
- scripts
- Updated launcher executables.
Code relating to support for Python 2.6 was also removed.
0.3.3
~~~~~
Released: 2021-09-22
- compat
- Fixed #152: Removed splituser() function which wasn't used and is deprecated.
- markers
- Fixed #149: Handle version comparisons correctly in environment markers.
- scripts
- Add ARM-64 launchers and support code to use them. Thanks to Niyas Sait and
Adrian Vladu for their contributions.
- util
- Fixed #148: Handle a single trailing comma following a version. Thanks to Blazej
Floch for the report and suggested fix.
- version
- Fixed #150: Fix incorrect handling of epochs.
- wheel
- Reverted handling of tags for Python >= 3.10 (use 310 rather than 3_10). This is
because PEP 641 was rejected.
- tests
- Made changes relating to implementing CI using GitHub Actions.
0.3.2
~~~~~
Released: 2021-05-29
- locators
- Fixed #141: removed unused regular expression.
- metadata
- Fixed #140: allowed "Obsoletes" in more scenarios, to better handle faulty
metadata already on PyPI.
- resources
- Fixed #146: added entry for SourcelessFileLoader to the finder registry.
- scripts
- Made the generation of scripts more configurable:
- the ``variant_separator`` attribute can be set to determine the separator used
between a script basename and its X.Y variant. The default value is ``'-'``
and would result in a final script basename like ``'foo-X.Y'``, whereas
setting it to ``''`` would result in a final script basename like
``'fooX.Y'``.
- You can also subclass and override the ``get_script_filenames()`` method to
provide a more customised set of file basenames.
- util
- Fixed #140: allowed a trailing comma in constraints, to better handle faulty
metadata already on PyPI.
- Moved get_platform() logic from distutils to here.
- Fixed #143: removed normcase() to avoid some problems on Windows.
- wheel
- Dropped any trailing data when computing the Python tag.
- Added support for manylinux tags.
- Changed handling of tags for Python >= 3.10 (use 3_10 rather than 310).
- Fixed #147: permission bits are now preserved on POSIX when installing from a
wheel.
- tests
- Fixed #139: improved handling of errors related to the test PyPI server.
0.3.1
~~~~~
Released: 2020-06-27
The repository has been migrated to Git. References to earlier changesets (commits) in
issue comments, etc. will be invalid.
- scripts
- Fixed #132: Added documentation to help with relative interpreter paths. Thanks
to Paul Kienzle for the patch.
- Fixed #134: Allowed specifying a different target Python version when generating
scripts.
- Fixed #135: Exposed the ``enquote_executable`` function previously implemented
as an internal function.
- Addressed #138: Improved metadata support for newer metadata versions. Thanks to
James Tocknell for the patch.
- wheel
- Changed the output of flags in entry point definitions. Thanks to frostming (明希)
for the patch.
- Stopped writing JSON metadata. Only old-style metadata is written now.
0.3.0
~~~~~
Released: 2019-10-29
- database
- Issue #102 (partial): modules attribute of InstalledDistribution was
incorrectly computed as a list of bytes, rather than a list of str. This
has now been corrected.
- locators
- Updated Locator._get_digest to check PyPI JSON responses for a "digests"
dictionary before trying "algo_digest" keys. Thanks to Jeffery To for the
patch.
- scripts
- Fixed #123: Improved error message if a resource isn't found.
- Fixed #124: Stopped norm-casing the executable written into shebangs, as
it doesn't work for some non-ASCII paths.
- Fixed #125: Updated launchers with versions that correctly report errors
containing non-ASCII characters. The updated launchers now also support
relative paths (see http://bit.ly/2JxmOoi for more information).
- Changed Python version handling to accommodate versions like e.g. 3.10
(no longer assume a version X.Y where X and Y are single digits).
- util
- Fixed #127: Allowed hyphens in flags in export specifications.
- wheel
- Changed Python version handling to accommodate versions like e.g. 3.10
(no longer assume a version X.Y where X and Y are single digits).
0.2.9
~~~~~
Released: 2019-05-14
- index
- Updated default PyPI URL to https://pypi.org/pypi.
- locators
- Updated default PyPI URL to https://pypi.org/pypi.
- metadata
- Relaxed metadata format checks to ignore 'Provides'.
- scripts
- Fixed #33, #34: Simplified script template.
- Updated Windows launchers.
- util
- Fixed #116: Corrected parsing of credentials from URLs.
- wheel
- Fixed #115: Relaxed check for '..' in wheel archive entries by not
checking filename parts, only directory segments.
- Skip entries in archive entries ending with '/' (directories) when
verifying or installing.
- docs
- Updated default PyPI URL to https://pypi.org/pypi.
- Commented out Disqus comment section.
- Changed theme configuration.
- Updated some out-of-date argument lists.
- tests
- Updated default PyPI URL to https://pypi.org/pypi.
- Preserved umask on POSIX across a test.
0.2.8
~~~~~
Released: 2018-10-01
- database
- Fixed #108: Updated metadata scan to look for the METADATA file as well
as the JSON formats.
- locators
- Fixed #112: Handled wheel tags and platform-dependent downloads correctly
in SimpleScrapingLocator.
- metadata
- Fixed #107: Updated documentation on testing to include information on
setting PYTHONHASHSEED.
- scripts
- Fixed #111: Avoided unnecessary newlines in script preambles, which caused
problems with detecting encoding declarations. Thanks to Wim Glenn for the
report and patch.
- util
- Fixed #109: Removed existing files (which might have been symlinks) before
overwriting.
0.2.7
~~~~~
Released: 2018-04-16
- compat
- Fixed #105: cache_from_source is now imported from importlib.util where
available.
- database
- Addressed #102: InstalledDistributions now have a modules attribute which
is a list of top-level modules as read from top_level.txt, if that is in
the distribution info.
- locators
- Fixed #103: Thanks to Saulius Žemaitaitis for the patch.
- metadata
- Added support for PEP 566 / Metadata 1.3.
- scripts
- Fixed #104: Updated launcher binaries. Thanks to Atsushi Odagiri for
the diagnosis and fix.
0.2.6
~~~~~
Released: 2017-10-28
- compat
- Fixed #99: Updated to handle a case where sys.getfilesystemencoding()
returns None.
- database
- Fixed #97: Eliminated a crash in EggInfoDistribution.list_distinfo_files()
which was caused by trying to open a non-existent file.
- Handled a case where an installed distribution didn't have 'Provides:'
metadata.
- locators
- Fixed #96: SimpleScrapingLocator no longer fails prematurely when scraping
links due to invalid versions.
- markers
- Improved error messages issued when interpreting markers
- scripts
- Improved the shebangs written into installed scripts when the interpreter
path is very long or contains spaces (to cater for a limitation in shebang
line parsing on Linux)
- Updated launcher binaries.
- tests
- Numerous test refinements, not detailed further here.
0.2.5
~~~~~
Released: 2017-05-06
- general
- Changed regular expressions to be compatible with 3.6 as regards escape
sequences. Thanks to Ville Skyttä for the patch.
- closed some resource leaks related to XML-RPC proxies.
- Removed Python 2.6 from the support list.
- locators
- Made downloadability a factor in scoring URLs for preferences.
- markers
- Replaced the implementation with code which parses requirements in
accordance with PEP 508 and evaluates marker expressions according to
PEP 508.
- util
- Changed _csv_open to use utf-8 across all platforms on Python 3.x. Thanks
to Alastair McCormack for the patch.
- wheel
- Changed to look for metadata in metadata.json as well as pydist.json.
- version
- Updated requirement parsing in version matchers to use the new
PEP 508-compliant code.
- tests
- Numerous test refinements, not detailed further here.
0.2.4
~~~~~
Released: 2016-09-30
- compat
- Updated to not fail on import if SSL is unavailable.
- index
- Switch from using gpg in preference to gpg2 for signing. This is
to avoid gpg2's behaviour of prompting for passwords, which interferes
with the tests on some machines.
- locators
- Changed project name comparisons to follow PEP 503. Thanks to Steven
Arcangeli for the patch.
- Added errors queue to Locator.
- manifest
- Changed match logic to work under Python 3.6, due to differences in
how fnmatch.translate behaves.
- resources
- Updated finder registry logic to reflect changes in Python 3.6.
- scripts
- Fixed regular expression in generated script boilerplate.
- util
- Updated to not fail on import if SSL is unavailable.
- Added normalize_name for project name comparisons using PEP 503.
- tests
- Updated to skip certain tests if SSL is unavailable.
- Numerous other test refinements, not detailed further here.
0.2.3
~~~~~
Released: 2016-04-30
- util
- Changed get_executable to return Unicode rather than bytes.
- Fixed #84: Allow + character in output script names.
- Relaxed too-stringent test looking for application/json in headers.
- wheel
- sorted the entries in RECORD before writing to file.
- tests
- Numerous test refinements, not detailed further here.
0.2.2
~~~~~
Released: 2016-01-30
- database
- Issue #81: Added support for detecting distributions installed by wheel
versions >= 0.23 (which use metadata.json rather than pydist.json).
Thanks to Te-jé Rodgers for the patch.
- locators
- Updated default PyPI URL to https://pypi.python.org/pypi
- metadata
- Updated to use different formatting for description field for V1.1
metadata.
- Corrected "classifier" to "classifiers" in the mapping for V1.0
metadata.
- scripts
- Improved support for Jython when quoting executables in output scripts.
- util
- Issue #77: Made the internal URL used for extended metadata fetches
configurable via a module attribute.
- Issue #78: Improved entry point parsing to handle leading spaces in
ini-format files.
- docs
- Numerous documentation updates, not detailed further here.
- tests
- renamed environment variable SKIP_SLOW to SKIP_ONLINE in tests and
applied to some more tests.
- Numerous other test refinements, not detailed further here.
0.2.1
~~~~~
Released: 2015-07-07
- locators
- Issue #58: Return a Distribution instance or None from ``locate()``.
- Issue #59: Skipped special keys when looking for versions.
- Improved behaviour of PyPIJSONLocator to be analogous to that of other
locators.
- resource
- Added resource iterator functionality.
- scripts
- Issue #71: Updated launchers to decode shebangs using UTF-8. This allows
non-ASCII pathnames to be correctly handled.
- Ensured that the executable written to shebangs is normcased.
- Changed ScriptMaker to work better under Jython.
- util
- Changed the mode setting method to work better under Jython.
- Changed get_executable() to return a normcased value.
- wheel
- Handled multiple-architecture wheel filenames correctly.
- docs
- Numerous documentation updates, not detailed further here.
- tests
- Numerous test refinements, not detailed further here.
0.2.0
~~~~~
Released: 2014-12-17
- compat
- Updated ``match_hostname`` to use the latest Python implementation.
- database
- Added `download_urls` and `digests` attributes to ``Distribution``.
- locators
- Issue #48: Fixed the problem of adding a tuple containing a set
(unhashable) to a set, by wrapping with frozenset().
- Issue #55: Return multiple download URLs for distributions, if
available.
- manifest
- Issue #57: Remove unhelpful warnings about pattern matches.
- metadata
- Updated to reflect changes to PEP 426.
- resources
- Issue #50: The type of the path needs to be preserved on 2.x.
- scripts
- Updated (including launchers) to support providing arguments to
interpreters in shebang lines.
- The launcher sources are now included in the repository and the
source distribution (they are to be found in the PC directory).
- Added frames support in IronPython (patch by Pawel Jasinski).
- Issue #51: encode shebang executable using utf-8 rather than fsencode.
- util
- Removed reference to __PYVENV_LAUNCHER__ when determining executable
for scripts (relevant only on macOS).
- Updated to support changes to PEP 426.
- version
- Updated to reflect changes to versioning proposed in PEP 440.
- wheel
- Updated build() code to respect interpreter arguments in prebuilt
scripts.
- Updated to support changes to PEP 426 / PEP 440.
- docs
- Numerous documentation updates, not detailed further here.
- tests
- Numerous test refinements, not detailed further here.
0.1.9
~~~~~
Released: 2014-05-19
- index
- Added ``keystore`` keyword argument to signing and verification
APIs.
- scripts
- Issue #47: Updated binary launchers to fix double-quoting bug where
script executable paths have spaces.
- docs
- Numerous documentation updates, not detailed further here.
- tests
- Numerous test refinements, not detailed further here.
0.1.8
~~~~~
Released: 2014-03-18
- index
- Improved thread-safety in SimpleScrapingLocator (issue #45).
- Replaced absolute imports with relative ones.
- Added ``search`` method to ``PackageIndex``.
- locators
- Improved thread-safety in ``SimpleScrapingLocator`` (issue #45).
- metadata
- Fixed bug in add_requirements implementation.
- resources
- The ``Cache`` class was refactored into ``distlib.util.Cache``
and ``distlib.resources.ResourceCache`` classes.
- scripts
- Implement quoting for executables with spaces in them.
- util
- Gained the ``Cache`` class, which is also used in ``distlib.wheel``.
- version
- Allowed versions with a single numeric component and a local
version component.
- Adjusted pre-release computation for legacy versions to be the same as
the logic in the setuptools documentation.
- wheel
- Added ``verify``, ``update``, ``is_compatible`` and ``is_mountable``
methods to the ``Wheel`` class.
- Converted local version separators from '-' to '_' and back.
- If SOABI not available, used Py_DEBUG, Py_UNICODE_SIZE and
WITH_PYMALLOC to derive the ABI.
- Added "exists" property to Wheel instances.
- Factored out RECORD writing and zip building to separate methods.
- Provided the ability to determine the location where extensions are
extracted, by using the ``distlib.util.Cache`` class.
- Avoided using ``pydist.json`` in 1.0 wheels (``bdist_wheel`` writes a
non-conforming ``pydist.json``.)
- Improved computation of compatible tags on macOS, and made COMPATIBLE_TAGS
a set.
- _backport/sysconfig
- Replaced an absolute import with a relative one.
- docs
- Numerous documentation updates, not detailed further here.
- tests
- Numerous test refinements, not detailed further here.
0.1.7
~~~~~
Released: 2014-01-16
- metadata
- Added some more fields to the metadata for the index.
- resources
- Use native literal string in cache path.
- Issue #40: Now does path adjustments differently for files and zips.
- scripts
- Improved checking for venvs when generating scripts.
- util
- Issue #39: Fall back to temporary directory for cache if home directory
unavailable.
- wheel
- Use native literal string in cache path.
0.1.6
~~~~~
Released: 2013-12-31
- scripts
- Updated binary launchers because the wrong variant was shipped
with the previous release.
- version
- Added support for local component in PEP 440 versions.
- tests
- Numerous test refinements, not detailed further here.
0.1.5
~~~~~
Released: 2013-12-15
- compat
- Changed source of import for unescape in Python >= 3.4.
- index
- Used dummy_threading when threading isn't available.
- Used https for default index.
- locators
- Used dummy_threading when threading isn't available.
- scripts
- Defaulted to setting script mode bits on POSIX.
- Use uncompressed executable launchers, since some anti-virus
products raise false positive errors.
- util
- Used dummy_threading when threading isn't available.
- docs
- Updated out-of-date links in overview.
- tests
- Used dummy_threading when threading isn't available.
0.1.4
~~~~~
Released: 2013-10-31
- scripts
- Updated the logic for finding the distlib package using a relative,
rather than absolute method. This fixes a problem for pip, where
distlib is kept in the pip.vendor.distlib package.
- _backport/sysconfig
- The analogous change to that made for scripts, described above.
0.1.3
~~~~~
Released: 2013-10-18
- database
- Added support for PEP 426 JSON metadata (pydist.json).
- Generalised digests to support e.g. SHA256.
- Fixed a bug in parsing legacy metadata from .egg directories.
- Removed duplicated code relating to parsing "provides" fields.
- index
- Changes relating to support for PEP 426 JSON metadata (pydist.json).
- locators
- Changes relating to support for PEP 426 JSON metadata (pydist.json).
- Fixed a bug in scoring download URLs for preference when multiple URLs
are available.
- The legacy scheme is used for the default locator.
- Made changes relating to parsing "provides" fields.
- Generalised digests to support e.g. SHA256.
- If no release version is found for a requirement, prereleases are
now considered even if not explicitly requested.
- markers
- Added support for markers as specified in PEP 426.
- metadata
- Added support for PEP 426 JSON metadata (pydist.json). The old
metadata class is renamed to LegacyMetadata, and the (new)
Metadata class wraps the JSON format (and also the legacy format,
through LegacyMetadata).
- Removed code which was only used if docutils was installed. This code
implemented validation of .rst descriptions, which is not done in
distlib.
- scripts
- Updated the logic for writing executable files to deal as best we can
with files which are already in use and hence cannot be deleted on
Windows.
- Changed the script generation when launchers are used to write a
single executable which wraps a script (whether pre-built or generated)
and includes a manifest to avoid UAC prompts on Windows.
- Changed the interface for script generation options: the ``make`` and
``make_multiple`` methods of ``ScriptMaker`` now take an optional
``options`` dictionary.
- util
- Added extract_by_key() to copy selected keys from one dict to another.
- Added parse_name_and_version() for use in parsing "provides" fields.
- Made split_filename more flexible.
- version
- Added support for PEP 440 version matching.
- Removed AdaptiveVersion, AdaptiveMatcher etc. as they don't add
sufficient value to justify keeping them in.
- wheel
- Added wheel_version kwarg to Wheel.build API.
- Changed Wheel.install API (after consultation on distutils-sig).
- Added support for PEP 426 JSON metadata (pydist.json).
- Added lib_only flag to install() method.
- docs
- Numerous documentation updates, not detailed further here.
- tests
- Numerous test refinements, not detailed further here.
0.1.2
~~~~~
Released: 2013-04-30
- compat
- Added BaseConfigurator backport for 2.6.
- database
- Return RECORD path from write_installed_files (or None if dry_run).
- Explicitly return None from write_shared_locations if dry run.
- metadata
- Added missing condition in :meth:`~distlib.metadata.Metadata.todict`.
- scripts
- Add variants and clobber flag for generation of foo/fooX/foo-X.Y.
- Added .exe manifests for Windows.
- util
- Regularised recording of written files.
- Added Configurator.
- version
- Tidyups, most suggested by Donald Stufft: Made key functions private,
removed _Common class, removed checking for huge version numbers, made
UnsupportedVersionError a ValueError.
- wheel
- Replaced absolute import with relative.
- Handle None return from write_shared_locations correctly.
- Fixed bug in Mounter for extension modules not in sub-packages.
- Made dylib-cache Python version-specific.
- docs
- Numerous documentation updates, not detailed further here.
- tests
- Numerous test refinements, not detailed further here.
- other
- Corrected setup.py to ensure that sysconfig.cfg is included.
0.1.1
~~~~~
Released: 2013-03-22
- database
- Updated requirements logic to use extras and environment markers.
- Made it easier to subclass Distribution and EggInfoDistribution.
- locators
- Added method to clear locator caches.
- Added the ability to skip pre-releases.
- manifest
- Fixed bug which caused side-effect when sorting a manifest.
- metadata
- Updated to handle most 2.0 fields, though PEP 426 is still a draft.
- Added the option to skip unset fields when writing.
- resources
- Made separate subclasses ResourceBase, Resource and ResourceContainer
from Resource. Thanks to Thomas Kluyver for the suggestion and patch.
- scripts
- Fixed bug which prevented writing shebang lines correctly on Windows.
- util
- Made get_cache_base more useful by parameterising the suffix to use.
- Fixed a bug when reading CSV streams from .zip files under 3.x.
- version
- Added is_prerelease property to versions.
- Moved to PEP 426 version formats and sorting.
- wheel
- Fixed CSV stream reading under 3.x and handled UTF-8 in zip entries
correctly.
- Added metadata and info properties, and updated the install method to
return the installed distribution.
- Added mount/unmount functionality.
- Removed compatible_tags() function in favour of COMPATIBLE_TAGS
attribute.
- docs
- Numerous documentation updates, not detailed further here.
- tests
- Numerous test refinements, not detailed further here.
0.1.0
~~~~~
Released: 2013-03-02
- Initial release.
././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1554793251.0
distlib-0.4.3/CONTRIBUTORS.txt 0000644 0001750 0001750 00000003155 13453041443 014751 0 ustar 00vinay vinay =======================
Distutils2 Contributors
=======================
The Distutils2 project was started by Tarek Ziadé and is currently
maintained by Éric Araujo. Many people have contributed to the project.
distlib has started off using some of the code from distutil2.
If you're making a patch, please add your name below in alphabetical order,
and welcome into the Fellowship of the Packaging!
Thanks to:
- Rajiv Abraham
- Ali Afshar
- David Barnett
- Pior Bastida
- Anthony Baxter
- Erik Bray
- C. Titus Brown
- Francisco Martín Brugué
- Nicolas Cadou
- Godefroid Chapelle
- Julien Courteau
- Christophe Combelles
- Jason R. Coombs
- Pierre-Yves David
- Ned Deily
- Konrad Delong
- Josip Djolonga
- John Edmonds
- André Espaze
- Boris Feld
- Andrew Francis
- Hallvard B Furuseth
- Patrice Gauthier
- Yannick Gingras
- Filip Gruszczyński
- Walker Hale IV
- Alexandre Hamelin
- Kelsey Hightower
- Thomas Holmes
- Preston Holmes
- Christian Hudon
- Julien Jehannet
- Jeremy Kloth
- Thomas Kluyver
- Amos Latteier
- Mathieu Leduc-Hamel
- Pierre Paul Lefebvre
- Tshepang Lekhonkhobe
- Alain Leufroy
- Janusz Lewandowski
- Martin von Löwis
- Hugo Lopes Tavares
- Guillermo López-Anglada
- Justin Love
- Simon Mathieu
- Carl Meyer
- Alexis Métaireau
- Julien Miotte
- Zubin Mithra
- Derek McTavish Mounce
- Paul Moore
- Michael Mulich
- Louis Munro
- Gaël Pasgrimaud
- George Peristerakis
- Mathieu Perreault
- Guillaume Pratte
- Sean Reifschneider
- Antoine Reversat
- Arc Riley
- C. Anthony Risinger
- Elson Rodriguez
- Luis Rojas
- Erik Rose
- Brian Rosner
- Vinay Sajip
- Victor Stinner
- Alexandre Vassalotti
- Nadeem Vawda
././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1781250013.0
distlib-0.4.3/LICENSE.txt 0000664 0001750 0001750 00000034303 15212733735 014106 0 ustar 00vinay vinay A. HISTORY OF THE SOFTWARE
==========================
Python was created in the early 1990s by Guido van Rossum at Stichting
Mathematisch Centrum (CWI, see http://www.cwi.nl) in the Netherlands
as a successor of a language called ABC. Guido remains Python's
principal author, although it includes many contributions from others.
In 1995, Guido continued his work on Python at the Corporation for
National Research Initiatives (CNRI, see http://www.cnri.reston.va.us)
in Reston, Virginia where he released several versions of the
software.
In May 2000, Guido and the Python core development team moved to
BeOpen.com to form the BeOpen PythonLabs team. In October of the same
year, the PythonLabs team moved to Digital Creations (now Zope
Corporation, see http://www.zope.com). In 2001, the Python Software
Foundation (PSF, see http://www.python.org/psf/) was formed, a
non-profit organization created specifically to own Python-related
Intellectual Property. Zope Corporation is a sponsoring member of
the PSF.
All Python releases are Open Source (see http://www.opensource.org for
the Open Source Definition). Historically, most, but not all, Python
releases have also been GPL-compatible; the table below summarizes
the various releases.
Release Derived Year Owner GPL-
from compatible? (1)
0.9.0 thru 1.2 1991-1995 CWI yes
1.3 thru 1.5.2 1.2 1995-1999 CNRI yes
1.6 1.5.2 2000 CNRI no
2.0 1.6 2000 BeOpen.com no
1.6.1 1.6 2001 CNRI yes (2)
2.1 2.0+1.6.1 2001 PSF no
2.0.1 2.0+1.6.1 2001 PSF yes
2.1.1 2.1+2.0.1 2001 PSF yes
2.2 2.1.1 2001 PSF yes
2.1.2 2.1.1 2002 PSF yes
2.1.3 2.1.2 2002 PSF yes
2.2.1 2.2 2002 PSF yes
2.2.2 2.2.1 2002 PSF yes
2.2.3 2.2.2 2003 PSF yes
2.3 2.2.2 2002-2003 PSF yes
2.3.1 2.3 2002-2003 PSF yes
2.3.2 2.3.1 2002-2003 PSF yes
2.3.3 2.3.2 2002-2003 PSF yes
2.3.4 2.3.3 2004 PSF yes
2.3.5 2.3.4 2005 PSF yes
2.4 2.3 2004 PSF yes
2.4.1 2.4 2005 PSF yes
2.4.2 2.4.1 2005 PSF yes
2.4.3 2.4.2 2006 PSF yes
2.4.4 2.4.3 2006 PSF yes
2.5 2.4 2006 PSF yes
2.5.1 2.5 2007 PSF yes
2.5.2 2.5.1 2008 PSF yes
2.5.3 2.5.2 2008 PSF yes
2.6 2.5 2008 PSF yes
2.6.1 2.6 2008 PSF yes
2.6.2 2.6.1 2009 PSF yes
2.6.3 2.6.2 2009 PSF yes
2.6.4 2.6.3 2009 PSF yes
2.6.5 2.6.4 2010 PSF yes
3.0 2.6 2008 PSF yes
3.0.1 3.0 2009 PSF yes
3.1 3.0.1 2009 PSF yes
3.1.1 3.1 2009 PSF yes
3.1.2 3.1 2010 PSF yes
3.2 3.1 2010 PSF yes
Footnotes:
(1) GPL-compatible doesn't mean that we're distributing Python under
the GPL. All Python licenses, unlike the GPL, let you distribute
a modified version without making your changes open source. The
GPL-compatible licenses make it possible to combine Python with
other software that is released under the GPL; the others don't.
(2) According to Richard Stallman, 1.6.1 is not GPL-compatible,
because its license has a choice of law clause. According to
CNRI, however, Stallman's lawyer has told CNRI's lawyer that 1.6.1
is "not incompatible" with the GPL.
Thanks to the many outside volunteers who have worked under Guido's
direction to make these releases possible.
B. TERMS AND CONDITIONS FOR ACCESSING OR OTHERWISE USING PYTHON
===============================================================
PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2
--------------------------------------------
1. This LICENSE AGREEMENT is between the Python Software Foundation
("PSF"), and the Individual or Organization ("Licensee") accessing and
otherwise using this software ("Python") in source or binary form and
its associated documentation.
2. Subject to the terms and conditions of this License Agreement, PSF hereby
grants Licensee a nonexclusive, royalty-free, world-wide license to reproduce,
analyze, test, perform and/or display publicly, prepare derivative works,
distribute, and otherwise use Python alone or in any derivative version,
provided, however, that PSF's License Agreement and PSF's notice of copyright,
i.e., "Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
Python Software Foundation; All Rights Reserved" are retained in Python alone or
in any derivative version prepared by Licensee.
3. In the event Licensee prepares a derivative work that is based on
or incorporates Python or any part thereof, and wants to make
the derivative work available to others as provided herein, then
Licensee hereby agrees to include in any such work a brief summary of
the changes made to Python.
4. PSF is making Python available to Licensee on an "AS IS"
basis. PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND
DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT
INFRINGE ANY THIRD PARTY RIGHTS.
5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON
FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS
A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON,
OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
6. This License Agreement will automatically terminate upon a material
breach of its terms and conditions.
7. Nothing in this License Agreement shall be deemed to create any
relationship of agency, partnership, or joint venture between PSF and
Licensee. This License Agreement does not grant permission to use PSF
trademarks or trade name in a trademark sense to endorse or promote
products or services of Licensee, or any third party.
8. By copying, installing or otherwise using Python, Licensee
agrees to be bound by the terms and conditions of this License
Agreement.
BEOPEN.COM LICENSE AGREEMENT FOR PYTHON 2.0
-------------------------------------------
BEOPEN PYTHON OPEN SOURCE LICENSE AGREEMENT VERSION 1
1. This LICENSE AGREEMENT is between BeOpen.com ("BeOpen"), having an
office at 160 Saratoga Avenue, Santa Clara, CA 95051, and the
Individual or Organization ("Licensee") accessing and otherwise using
this software in source or binary form and its associated
documentation ("the Software").
2. Subject to the terms and conditions of this BeOpen Python License
Agreement, BeOpen hereby grants Licensee a non-exclusive,
royalty-free, world-wide license to reproduce, analyze, test, perform
and/or display publicly, prepare derivative works, distribute, and
otherwise use the Software alone or in any derivative version,
provided, however, that the BeOpen Python License is retained in the
Software, alone or in any derivative version prepared by Licensee.
3. BeOpen is making the Software available to Licensee on an "AS IS"
basis. BEOPEN MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, BEOPEN MAKES NO AND
DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE WILL NOT
INFRINGE ANY THIRD PARTY RIGHTS.
4. BEOPEN SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF THE
SOFTWARE FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS
AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THE SOFTWARE, OR ANY
DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
5. This License Agreement will automatically terminate upon a material
breach of its terms and conditions.
6. This License Agreement shall be governed by and interpreted in all
respects by the law of the State of California, excluding conflict of
law provisions. Nothing in this License Agreement shall be deemed to
create any relationship of agency, partnership, or joint venture
between BeOpen and Licensee. This License Agreement does not grant
permission to use BeOpen trademarks or trade names in a trademark
sense to endorse or promote products or services of Licensee, or any
third party. As an exception, the "BeOpen Python" logos available at
http://www.pythonlabs.com/logos.html may be used according to the
permissions granted on that web page.
7. By copying, installing or otherwise using the software, Licensee
agrees to be bound by the terms and conditions of this License
Agreement.
CNRI LICENSE AGREEMENT FOR PYTHON 1.6.1
---------------------------------------
1. This LICENSE AGREEMENT is between the Corporation for National
Research Initiatives, having an office at 1895 Preston White Drive,
Reston, VA 20191 ("CNRI"), and the Individual or Organization
("Licensee") accessing and otherwise using Python 1.6.1 software in
source or binary form and its associated documentation.
2. Subject to the terms and conditions of this License Agreement, CNRI
hereby grants Licensee a nonexclusive, royalty-free, world-wide
license to reproduce, analyze, test, perform and/or display publicly,
prepare derivative works, distribute, and otherwise use Python 1.6.1
alone or in any derivative version, provided, however, that CNRI's
License Agreement and CNRI's notice of copyright, i.e., "Copyright (c)
1995-2001 Corporation for National Research Initiatives; All Rights
Reserved" are retained in Python 1.6.1 alone or in any derivative
version prepared by Licensee. Alternately, in lieu of CNRI's License
Agreement, Licensee may substitute the following text (omitting the
quotes): "Python 1.6.1 is made available subject to the terms and
conditions in CNRI's License Agreement. This Agreement together with
Python 1.6.1 may be located on the Internet using the following
unique, persistent identifier (known as a handle): 1895.22/1013. This
Agreement may also be obtained from a proxy server on the Internet
using the following URL: http://hdl.handle.net/1895.22/1013".
3. In the event Licensee prepares a derivative work that is based on
or incorporates Python 1.6.1 or any part thereof, and wants to make
the derivative work available to others as provided herein, then
Licensee hereby agrees to include in any such work a brief summary of
the changes made to Python 1.6.1.
4. CNRI is making Python 1.6.1 available to Licensee on an "AS IS"
basis. CNRI MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, CNRI MAKES NO AND
DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 1.6.1 WILL NOT
INFRINGE ANY THIRD PARTY RIGHTS.
5. CNRI SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON
1.6.1 FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS
A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON 1.6.1,
OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
6. This License Agreement will automatically terminate upon a material
breach of its terms and conditions.
7. This License Agreement shall be governed by the federal
intellectual property law of the United States, including without
limitation the federal copyright law, and, to the extent such
U.S. federal law does not apply, by the law of the Commonwealth of
Virginia, excluding Virginia's conflict of law provisions.
Notwithstanding the foregoing, with regard to derivative works based
on Python 1.6.1 that incorporate non-separable material that was
previously distributed under the GNU General Public License (GPL), the
law of the Commonwealth of Virginia shall govern this License
Agreement only as to issues arising under or with respect to
Paragraphs 4, 5, and 7 of this License Agreement. Nothing in this
License Agreement shall be deemed to create any relationship of
agency, partnership, or joint venture between CNRI and Licensee. This
License Agreement does not grant permission to use CNRI trademarks or
trade name in a trademark sense to endorse or promote products or
services of Licensee, or any third party.
8. By clicking on the "ACCEPT" button where indicated, or by copying,
installing or otherwise using Python 1.6.1, Licensee agrees to be
bound by the terms and conditions of this License Agreement.
ACCEPT
CWI LICENSE AGREEMENT FOR PYTHON 0.9.0 THROUGH 1.2
--------------------------------------------------
Copyright (c) 1991 - 1995, Stichting Mathematisch Centrum Amsterdam,
The Netherlands. All rights reserved.
Permission to use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby granted,
provided that the above copyright notice appear in all copies and that
both that copyright notice and this permission notice appear in
supporting documentation, and that the name of Stichting Mathematisch
Centrum or CWI not be used in advertising or publicity pertaining to
distribution of the software without specific, written prior
permission.
STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO
THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE
FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1689762787.0
distlib-0.4.3/MANIFEST.in 0000644 0001750 0001750 00000000421 14455735743 014022 0 ustar 00vinay vinay include README.rst CHANGES.rst LICENSE.txt CONTRIBUTORS.txt tox.ini
include distlib/*.exe
recursive-include tests *
recursive-include PC *
global-exclude *.log __pycache__ *.pyc *.pyo
exclude tests/*pypi*
prune tests/pypiserver
prune tests/packages
exclude tests/passwords
././@PaxHeader 0000000 0000000 0000000 00000000034 00000000000 010212 x ustar 00 28 mtime=1781251341.4995327
distlib-0.4.3/PC/ 0000775 0001750 0001750 00000000000 15212736415 012560 5 ustar 00vinay vinay ././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1572260752.0
distlib-0.4.3/PC/CLISimpleLauncher.vcxproj 0000644 0001750 0001750 00000027106 13555545620 017450 0 ustar 00vinay vinay
Debug
Win32
Debug
x64
Release
Win32
Release
x64
{A0AB4387-243A-48F7-881D-DE138DDE68BA}
SimpleLauncher
Win32Proj
Application
MultiByte
true
Application
MultiByte
Application
MultiByte
true
Application
MultiByte
<_ProjectFileVersion>10.0.40219.1
$(SolutionDir)$(Configuration)\
$(Configuration)\
true
$(SolutionDir)$(Platform)\$(Configuration)\
$(Platform)\$(Configuration)\
true
$(SolutionDir)dist\
$(Configuration)\
false
$(SolutionDir)dist\
$(Platform)\$(Configuration)\
false
AllRules.ruleset
AllRules.ruleset
AllRules.ruleset
AllRules.ruleset
t64
t32
Link
Link
Disabled
WIN32;_DEBUG;_CONSOLE;%(PreprocessorDefinitions)
true
EnableFastChecks
MultiThreaded
Default
Level3
EditAndContinue
true
true
$(OutDir)$(ProjectName).map
true
Console
MachineX86
python make_test.py
test\test.exe
$(OutDir)$(TargetName)$(TargetExt) make_test.py
X64
Disabled
WIN32;_DEBUG;_CONSOLE;%(PreprocessorDefinitions)
true
EnableFastChecks
MultiThreaded
Level3
ProgramDatabase
true
true
$(OutDir)$(ProjectName).map
true
Console
MachineX64
python make_test.py
test\test.exe
$(OutDir)$(TargetName)$(TargetExt) make_test.py
MinSpace
true
Size
WIN32;NDEBUG;_CONSOLE;%(PreprocessorDefinitions)
MultiThreaded
true
Level3
ProgramDatabase
dist\t32.exe
true
true
$(OutDir)$(ProjectName).map
true
Console
true
true
MachineX86
X64
MinSpace
true
Size
WIN32;NDEBUG;_CONSOLE;%(PreprocessorDefinitions)
MultiThreaded
true
Level3
ProgramDatabase
dist\t64.exe
true
true
$(OutDir)$(ProjectName).map
true
Console
true
true
MachineX64
././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1572260752.0
distlib-0.4.3/PC/GUISimpleLauncher.vcxproj 0000644 0001750 0001750 00000025357 13555545620 017473 0 ustar 00vinay vinay
Debug
Win32
Debug
x64
Release
Win32
Release
x64
{6295B87B-6312-4D7D-BCE9-A3626FD25417}
GUISimpleLauncher
Win32Proj
Application
MultiByte
true
Application
MultiByte
Application
MultiByte
true
Application
MultiByte
<_ProjectFileVersion>10.0.40219.1
$(SolutionDir)$(Configuration)\
$(Configuration)\
true
$(SolutionDir)$(Platform)\$(Configuration)\
$(Platform)\$(Configuration)\
true
$(SolutionDir)dist\
$(Configuration)\
false
$(SolutionDir)dist\
$(Platform)\$(Configuration)\
false
AllRules.ruleset
AllRules.ruleset
AllRules.ruleset
AllRules.ruleset
w32
w64
Disabled
WIN32;_DEBUG;_WINDOWS;%(PreprocessorDefinitions)
true
EnableFastChecks
MultiThreaded
Level3
EditAndContinue
true
true
$(OutDir)$(ProjectName).map
true
Windows
MachineX86
X64
Disabled
WIN32;_DEBUG;_WINDOWS;%(PreprocessorDefinitions)
true
EnableFastChecks
MultiThreaded
Level3
ProgramDatabase
true
true
$(OutDir)$(ProjectName).map
true
Windows
MachineX64
MinSpace
true
Size
WIN32;NDEBUG;_WINDOWS;%(PreprocessorDefinitions)
MultiThreaded
true
Level3
ProgramDatabase
dist\w32.exe
true
true
$(OutDir)$(ProjectName).map
true
Windows
true
true
MachineX86
X64
MinSpace
true
Size
WIN32;NDEBUG;_WINDOWS;%(PreprocessorDefinitions)
MultiThreaded
true
Level3
ProgramDatabase
dist\w64.exe
true
true
$(OutDir)$(ProjectName).map
true
Windows
true
true
MachineX64
././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1554793251.0
distlib-0.4.3/PC/ReadMe.txt 0000644 0001750 0001750 00000003734 13453041443 014456 0 ustar 00vinay vinay This is a simple launcher for Python files, which is functionally equivalent to
the launchers in setuptools but not based on setuptools code. There are two
versions of the launcher - console and GUI - built from the same source code.
The launcher has been written as part of the pythonv branch, and is intended
to facilitate location of the correct Python executable for a script in an
environment where there may be multiple versions of Python deployed.
The launcher is intended to facilitate script execution under Windows where a
PEP 397-compatible launcher is not available. The idea is that each Python
script has a copy of the launcher (symlinks not being generally available
under Windows). For scripts to work with the launcher, they have to have a name
ending in -script.py (for a console script) or -script.pyw (for a GUI script).
The deployment system (e.g. packaging) will ensure that for foo-script.py, a
console launcher opy named foo.exe is placed in the same directory; for
bar-script.pyw, a GUI launcher copy named bar.exe is placed in the same
directory.
Assuming that the relevant directories are on the path, the scripts can be
invoked using just "foo" or "bar". The foo.exe or bar.exe executable then
runs: it looks for a script with the appropriate suffix ("-script.py" or
"-script.pyw") in the same directory, and if found, opens that script to read a
shebang line indicating which Python executable to use for the script. That
executable, if found, is launched with the script and other arguments passed:
foo a b c -> c:\path\to\python.exe c:\other\path\to\foo-script.py a b c
bar d e f -> c:\path\to\pythonw.exe c:\other\path\to\bar-script.pyw d e f
Note: More recently, the launchers have been updated to find their script in an
archive appended to the executable, rather than a separate file. (This variant
is enabled when APPENDED_ARCHIVE is #defined). This allows the launchers to be
used to e.g. run .pyz archives as native Windows executables.
././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1572260752.0
distlib-0.4.3/PC/SimpleLauncher.sln 0000644 0001750 0001750 00000003752 13555545620 016222 0 ustar 00vinay vinay
Microsoft Visual Studio Solution File, Format Version 11.00
# Visual Studio 2010
Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "CLISimpleLauncher", "CLISimpleLauncher.vcxproj", "{A0AB4387-243A-48F7-881D-DE138DDE68BA}"
EndProject
Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "GUISimpleLauncher", "GUISimpleLauncher.vcxproj", "{6295B87B-6312-4D7D-BCE9-A3626FD25417}"
EndProject
Global
GlobalSection(SolutionConfigurationPlatforms) = preSolution
Debug|Win32 = Debug|Win32
Debug|x64 = Debug|x64
Release|Win32 = Release|Win32
Release|x64 = Release|x64
EndGlobalSection
GlobalSection(ProjectConfigurationPlatforms) = postSolution
{A0AB4387-243A-48F7-881D-DE138DDE68BA}.Debug|Win32.ActiveCfg = Debug|Win32
{A0AB4387-243A-48F7-881D-DE138DDE68BA}.Debug|Win32.Build.0 = Debug|Win32
{A0AB4387-243A-48F7-881D-DE138DDE68BA}.Debug|x64.ActiveCfg = Debug|x64
{A0AB4387-243A-48F7-881D-DE138DDE68BA}.Debug|x64.Build.0 = Debug|x64
{A0AB4387-243A-48F7-881D-DE138DDE68BA}.Release|Win32.ActiveCfg = Release|Win32
{A0AB4387-243A-48F7-881D-DE138DDE68BA}.Release|Win32.Build.0 = Release|Win32
{A0AB4387-243A-48F7-881D-DE138DDE68BA}.Release|x64.ActiveCfg = Release|x64
{A0AB4387-243A-48F7-881D-DE138DDE68BA}.Release|x64.Build.0 = Release|x64
{6295B87B-6312-4D7D-BCE9-A3626FD25417}.Debug|Win32.ActiveCfg = Debug|Win32
{6295B87B-6312-4D7D-BCE9-A3626FD25417}.Debug|Win32.Build.0 = Debug|Win32
{6295B87B-6312-4D7D-BCE9-A3626FD25417}.Debug|x64.ActiveCfg = Debug|x64
{6295B87B-6312-4D7D-BCE9-A3626FD25417}.Debug|x64.Build.0 = Debug|x64
{6295B87B-6312-4D7D-BCE9-A3626FD25417}.Release|Win32.ActiveCfg = Release|Win32
{6295B87B-6312-4D7D-BCE9-A3626FD25417}.Release|Win32.Build.0 = Release|Win32
{6295B87B-6312-4D7D-BCE9-A3626FD25417}.Release|x64.ActiveCfg = Release|x64
{6295B87B-6312-4D7D-BCE9-A3626FD25417}.Release|x64.Build.0 = Release|x64
EndGlobalSection
GlobalSection(SolutionProperties) = preSolution
HideSolutionNode = FALSE
EndGlobalSection
EndGlobal
././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1659773708.0
distlib-0.4.3/PC/launcher.c 0000664 0001750 0001750 00000101122 14273421414 014516 0 ustar 00vinay vinay /*
* Copyright (C) 2011-2022 Vinay Sajip. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* 1. Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
#ifndef _WIN32_WINNT // Specifies that the minimum required platform is Windows Vista.
#define _WIN32_WINNT 0x0600 // Change this to the appropriate value to target other versions of Windows.
#endif
#include
#include
#include
#include
#include
#pragma comment (lib, "Shlwapi.lib")
#define APPENDED_ARCHIVE
#define USE_ENVIRONMENT
#define SUPPORT_RELATIVE_PATH
#define MSGSIZE 1024
#if !defined(APPENDED_ARCHIVE)
static wchar_t suffix[] = {
#if defined(_CONSOLE)
L"-script.py"
#else
L"-script.pyw"
#endif
};
#endif
#if defined(SUPPORT_RELATIVE_PATH)
#define RELATIVE_PREFIX L"\\"
#define RELATIVE_PREFIX_LENGTH 15
#endif
#if !defined(_CONSOLE)
typedef int (__stdcall *MSGBOXWAPIA)(IN HWND hWnd,
IN LPCSTR lpText, IN LPCSTR lpCaption,
IN UINT uType, IN WORD wLanguageId, IN DWORD dwMilliseconds);
typedef int (__stdcall *MSGBOXWAPIW)(IN HWND hWnd,
IN LPWSTR lpText, IN LPWSTR lpCaption,
IN UINT uType, IN WORD wLanguageId, IN DWORD dwMilliseconds);
#define MB_TIMEDOUT 32000
int MessageBoxTimeoutA(HWND hWnd, LPCSTR lpText,
LPCSTR lpCaption, UINT uType, WORD wLanguageId, DWORD dwMilliseconds)
{
static MSGBOXWAPIA MsgBoxTOA = NULL;
HMODULE hUser = LoadLibraryA("user32.dll");
if (!MsgBoxTOA) {
if (hUser)
MsgBoxTOA = (MSGBOXWAPIA)GetProcAddress(hUser,
"MessageBoxTimeoutA");
else {
/*
* stuff happened, add code to handle it here
* (possibly just call MessageBox())
*/
}
}
if (MsgBoxTOA)
return MsgBoxTOA(hWnd, lpText, lpCaption, uType, wLanguageId,
dwMilliseconds);
if (hUser)
FreeLibrary(hUser);
return 0;
}
int MessageBoxTimeoutW(HWND hWnd, LPWSTR lpText,
LPWSTR lpCaption, UINT uType, WORD wLanguageId, DWORD dwMilliseconds)
{
static MSGBOXWAPIW MsgBoxTOW = NULL;
HMODULE hUser = LoadLibraryA("user32.dll");
if (!MsgBoxTOW) {
if (hUser)
MsgBoxTOW = (MSGBOXWAPIW)GetProcAddress(hUser,
"MessageBoxTimeoutW");
else {
/*
* stuff happened, add code to handle it here
* (possibly just call MessageBox())
*/
}
}
if (MsgBoxTOW)
return MsgBoxTOW(hWnd, lpText, lpCaption, uType, wLanguageId,
dwMilliseconds);
if (hUser)
FreeLibrary(hUser);
return 0;
}
#endif
static void
wassert(BOOL condition, wchar_t * format, ... )
{
if (!condition) {
va_list va;
wchar_t message[MSGSIZE];
int len;
va_start(va, format);
len = _vsnwprintf_s(message, MSGSIZE, MSGSIZE - 1, format, va);
#if defined(_CONSOLE)
fwprintf(stderr, L"Fatal error in launcher: %s\n", message);
#else
MessageBoxTimeoutW(NULL, message, L"Fatal Error in Launcher",
MB_OK | MB_SETFOREGROUND | MB_ICONERROR,
0, 3000);
#endif
ExitProcess(1);
}
}
static void
assert(BOOL condition, char * format, ... )
{
if (!condition) {
va_list va;
char message[MSGSIZE];
int len;
va_start(va, format);
len = vsnprintf_s(message, MSGSIZE, MSGSIZE - 1, format, va);
#if defined(_CONSOLE)
fprintf(stderr, "Fatal error in launcher: %s\n", message);
#else
MessageBoxTimeoutA(NULL, message, "Fatal Error in Launcher",
MB_OK | MB_SETFOREGROUND | MB_ICONERROR,
0, 3000);
#endif
ExitProcess(1);
}
}
static wchar_t script_path[MAX_PATH];
#if defined(APPENDED_ARCHIVE)
#define LARGE_BUFSIZE (65 * 1024 * 1024)
typedef struct {
DWORD sig;
DWORD unused_disk_nos;
DWORD unused_numrecs;
DWORD cdsize;
DWORD cdoffset;
} ENDCDR;
/* We don't want to pick up this variable when scanning the executable.
* So we initialise it statically, but fill in the first byte later.
*/
static char
end_cdr_sig [4] = { 0x00, 0x4B, 0x05, 0x06 };
static char *
find_pattern(char *buffer, size_t bufsize, char * pattern, size_t patsize)
{
char * result = NULL;
char * p;
char * bp = buffer;
size_t n;
while ((n = bufsize - (bp - buffer) - patsize) >= 0) {
p = (char *) memchr(bp, pattern[0], n);
if (p == NULL)
break;
if (memcmp(pattern, p, patsize) == 0) {
result = p; /* keep trying - we want the last one */
}
bp = p + 1;
}
return result;
}
static char *
find_shebang(char * buffer, size_t bufsize)
{
FILE * fp = NULL;
errno_t rc;
char * result = NULL;
char * p;
size_t read;
long pos;
__int64 file_size;
__int64 end_cdr_offset = -1;
ENDCDR end_cdr;
rc = _wfopen_s(&fp, script_path, L"rb");
assert(rc == 0, "Failed to open executable");
fseek(fp, 0, SEEK_END);
file_size = ftell(fp);
pos = (long) (file_size - bufsize);
if (pos < 0)
pos = 0;
fseek(fp, pos, SEEK_SET);
read = fread(buffer, sizeof(char), bufsize, fp);
p = find_pattern(buffer, read, end_cdr_sig, sizeof(end_cdr_sig));
if (p != NULL) {
end_cdr = *((ENDCDR *) p);
end_cdr_offset = pos + (p - buffer);
}
else {
/*
* Try a larger buffer. A comment can only be 64K long, so
* go for the largest size.
*/
char * big_buffer = malloc(LARGE_BUFSIZE);
int n = (int) LARGE_BUFSIZE;
pos = (long) (file_size - n);
if (pos < 0)
pos = 0;
fseek(fp, pos, SEEK_SET);
read = fread(big_buffer, sizeof(char), n, fp);
p = find_pattern(big_buffer, read, end_cdr_sig, sizeof(end_cdr_sig));
assert(p != NULL, "Unable to find an appended archive.");
end_cdr = *((ENDCDR *) p);
end_cdr_offset = pos + (p - big_buffer);
free(big_buffer);
}
end_cdr_offset -= end_cdr.cdsize + end_cdr.cdoffset;
/*
* end_cdr_offset should now be pointing to the start of the archive.
* However, the "start of the archive" is a little ill-defined, as
* not all means of prepending data to a zipfile handle the central
* directory offset the same way (simple file content appends leave
* it alone, obviously, but the stdlib zipapp and zipfile modules
* reflect the prepended data in the offset).
* We consider two possibilities here:
* 1. end_cdr_offset points to the start of the shebang (zipapp)
* 2. end_cdr_offset points to the end of the shebang (data copy)
* We'll assume the shebang line has no # or ! chars except at the
* beginning, and fits into bufsize (which should be MAX_PATH).
*/
/* Check for case 1 - we are at the start of the shebang */
fseek(fp, (long) end_cdr_offset, SEEK_SET);
read = fread(buffer, sizeof(char), bufsize, fp);
assert(read > 0, "Unable to read from file");
if (memcmp(buffer, "#!", 2) == 0) {
result = buffer;
}
else {
/* We are not at the start, so check backward bufsize bytes */
pos = (long) (end_cdr_offset - bufsize);
if (pos < 0)
pos = 0;
fseek(fp, pos, SEEK_SET);
read = fread(buffer, sizeof(char), bufsize, fp);
assert(read > 0, "Unable to read from file");
p = &buffer[read - 1];
while (p >= buffer) {
if (memcmp(p, "#!", 2) == 0) {
result = p;
break;
}
--p;
}
}
fclose(fp);
return result;
}
#endif
#if defined(USE_ENVIRONMENT)
/*
* Where to place any executable found on the path. Should be OK to use a
* static as there's only one of these per invocation of this executable.
*/
static wchar_t path_executable[MSGSIZE];
static BOOL find_on_path(wchar_t * name)
{
wchar_t * pathext;
size_t varsize;
wchar_t * context = NULL;
wchar_t * extension;
DWORD len;
errno_t rc;
BOOL found = FALSE;
if (wcschr(name, L'.') != NULL) {
/* assume it has an extension. */
if (SearchPathW(NULL, name, NULL, MSGSIZE, path_executable, NULL))
found = TRUE;
}
else {
/* No extension - search using registered extensions. */
rc = _wdupenv_s(&pathext, &varsize, L"PATHEXT");
_wcslwr_s(pathext, varsize);
if (rc == 0) {
extension = wcstok_s(pathext, L";", &context);
while (extension) {
len = SearchPathW(NULL, name, extension, MSGSIZE, path_executable, NULL);
if (len) {
found = TRUE;
break;
}
extension = wcstok_s(NULL, L";", &context);
}
free(pathext);
}
}
return found;
}
/*
* Find an executable in the environment. For now, we just look in the path,
* but potentially we could expand this to look in the registry, etc.
*/
static wchar_t *
find_environment_executable(wchar_t * line) {
BOOL found = find_on_path(line);
return found ? path_executable : NULL;
}
#endif
static wchar_t *
skip_ws(wchar_t *p)
{
while (*p && iswspace(*p))
++p;
return p;
}
static wchar_t *
skip_me(wchar_t * p)
{
wchar_t * result;
wchar_t terminator;
if (*p != L'\"')
terminator = L' ';
else {
terminator = *p++;
++p;
}
result = wcschr(p, terminator);
if (result == NULL) /* perhaps nothing more on the command line */
result = L"";
else
result = skip_ws(++result);
return result;
}
static char *
find_terminator(char *buffer, size_t size)
{
char c;
char * result = NULL;
char * end = buffer + size;
char * p;
for (p = buffer; p < end; p++) {
c = *p;
if (c == '\r') {
result = p;
break;
}
if (c == '\n') {
result = p;
break;
}
}
return result;
}
#if defined(DUPLICATE_HANDLES)
static BOOL
safe_duplicate_handle(HANDLE in, HANDLE * pout)
{
BOOL ok;
HANDLE process = GetCurrentProcess();
#if defined(_CONSOLE)
DWORD rc;
#endif
*pout = NULL;
/*
* See https://github.com/pypa/pip/issues/10444 - for the GUI launcher,
* errors are returned by DuplicateHandle. There may be no good reason
* why a GUI process would want to use these handles, but for now we
* attempt duplication but ignore errors in the GUI case.
*/
ok = DuplicateHandle(process, in, process, pout, 0, TRUE,
DUPLICATE_SAME_ACCESS);
#if defined(_CONSOLE)
if (!ok) {
rc = GetLastError();
if (rc == ERROR_INVALID_HANDLE)
ok = TRUE;
}
return ok;
#else
return TRUE;
#endif
}
#endif
/*
* These items are global so that thet can be accessed
* from the Ctrl-C handler or other auxiliary routine.
*/
static PROCESS_INFORMATION child_process_info;
static JOBOBJECT_EXTENDED_LIMIT_INFORMATION job_info;
static HANDLE job;
static BOOL
control_key_handler(DWORD type)
{
/*
* See https://github.com/pypa/pip/issues/10444
*/
#if defined(OLD_LOGIC)
if ((type == CTRL_C_EVENT) || (type == CTRL_BREAK_EVENT)) {
return TRUE;
}
WaitForSingleObject(child_process_info.hProcess, INFINITE);
#else
switch (type) {
case CTRL_CLOSE_EVENT:
case CTRL_LOGOFF_EVENT:
case CTRL_SHUTDOWN_EVENT:
/*
* Allow the child to outlive the launcher, to carry out any
* cleanup for a graceful exit. It will either exit or get
* terminated by the session server.
*/
if (job != NULL) {
job_info.BasicLimitInformation.LimitFlags &=
~JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE;
SetInformationJobObject(
job, JobObjectExtendedLimitInformation,
&job_info, sizeof(job_info));
}
}
#endif
return TRUE;
}
#if !defined(_CONSOLE)
/*
* End the launcher's "app starting" cursor state.
*
* When Explorer launches a Windows (GUI) application, it displays
* the "app starting" (the "pointer + hourglass") cursor for a number
* of seconds, or until the app does something UI-ish (eg, creating a
* window, or fetching a message). As this launcher doesn't do this
* directly, that cursor remains even after the child process does these
* things. We avoid that by doing the stuff in here.
* See http://bugs.python.org/issue17290 and
* https://github.com/pypa/pip/issues/10444#issuecomment-973408601
*/
static void
clear_app_starting_state() {
MSG msg;
HWND hwnd;
PostMessageW(0, 0, 0, 0);
GetMessageW(&msg, 0, 0, 0);
/* Proxy the child's input idle event. */
WaitForInputIdle(child_process_info.hProcess, INFINITE);
/*
* Signal the process input idle event by creating a window and pumping
* sent messages. The window class isn't important, so just use the
* system "STATIC" class.
*/
hwnd = CreateWindowExW(0, L"STATIC", L"PyLauncher", 0, 0, 0, 0, 0,
HWND_MESSAGE, NULL, NULL, NULL);
/* Process all sent messages and signal input idle. */
PeekMessageW(&msg, hwnd, 0, 0, 0);
DestroyWindow(hwnd);
}
#endif
/*
* See https://github.com/pypa/pip/issues/10444#issuecomment-1055392299
*/
static BOOL
make_handle_inheritable(HANDLE handle)
{
DWORD file_type = GetFileType(handle);
// Ignore an invalid handle, non-file object type, unsupported file type,
// or a console file prior to Windows 8.
if (file_type == FILE_TYPE_UNKNOWN ||
(file_type == FILE_TYPE_CHAR && ((ULONG_PTR)handle & 3))) {
return TRUE;
}
return SetHandleInformation(handle, HANDLE_FLAG_INHERIT,
HANDLE_FLAG_INHERIT);
}
static void
__cdecl
silent_invalid_parameter_handler(
wchar_t const* expression,
wchar_t const* function,
wchar_t const* file,
unsigned int line,
uintptr_t pReserved
)
{
}
/*
* Best-effort cleanup of any C file descriptors that were inherited
* from the parent process. This cleans up all fds except 0-2.
*/
static void
cleanup_fds(WORD cbReserved2, LPBYTE lpReserved2)
{
int handle_count = 0;
UNALIGNED HANDLE* first_handle = NULL;
UNALIGNED HANDLE* current_handle = NULL;
_invalid_parameter_handler old_handler = NULL;
// The structure is: , ,
if (cbReserved2 < sizeof(int) || NULL == lpReserved2)
{
return;
}
handle_count = *(UNALIGNED int*)lpReserved2;
// Verify the buffer is large enough
if (cbReserved2 < sizeof(int) + handle_count + sizeof(HANDLE) * handle_count)
{
return;
}
first_handle = (UNALIGNED HANDLE *)(lpReserved2 + sizeof(int) + handle_count);
old_handler = _set_invalid_parameter_handler(&silent_invalid_parameter_handler);
{
// Close all fds inherited from the parent, except for the standard I/O fds.
// We'll deal with those later.
for (current_handle = first_handle + 3; current_handle < first_handle + handle_count; ++current_handle)
{
// Ignore invalid handles, as that means this fd was not inherited.
// -2 is a special value (https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/get-osfhandle?view=msvc-170)
// that we check for just in case.
if (NULL == *current_handle || INVALID_HANDLE_VALUE == *current_handle || (HANDLE)-2 == *current_handle)
{
continue;
}
_close((int)(current_handle - first_handle));
}
}
_set_invalid_parameter_handler(old_handler);
}
/*
* Returns the HANDLE associated with a FILE* object, or INVALID_HANDLE_VALUE
* on error.
*/
static HANDLE
get_stream_handle(FILE * stream)
{
_invalid_parameter_handler old_handler = NULL;
int fd = -1;
HANDLE handle = INVALID_HANDLE_VALUE;
old_handler = _set_invalid_parameter_handler(&silent_invalid_parameter_handler);
{
fd = _fileno(stream);
if (fd >= 0)
{
handle = (HANDLE)_get_osfhandle(fd);
}
else
{
handle = INVALID_HANDLE_VALUE;
}
}
_set_invalid_parameter_handler(old_handler);
return handle;
}
/*
* Closes the Windows standard I/O handles (GetStdHandle)
* in a best-effort manner. Ensures that the stderr stream is left untouched.
*/
static void
cleanup_standard_io(void)
{
HANDLE stdin_handle = INVALID_HANDLE_VALUE;
HANDLE stdout_handle = INVALID_HANDLE_VALUE;
HANDLE stderr_handle = INVALID_HANDLE_VALUE;
HANDLE hStdIn = INVALID_HANDLE_VALUE;
HANDLE hStdOut = INVALID_HANDLE_VALUE;
HANDLE hStdErr = INVALID_HANDLE_VALUE;
// We need to close both the C streams stdin and stdout,
// and the Windows standard I/O handles. However, these may be equal,
// so care must be taken not to close a handle twice. Moreover,
// handles for several C streams may be equal as well.
// Fun all around.
// Get the handles associated with the standard I/O streams.
stdin_handle = get_stream_handle(stdin);
stdout_handle = get_stream_handle(stdout);
stderr_handle = get_stream_handle(stderr);
// If any two underlying handles are equal, drop everything and return.
// There's bound to be trouble if we continue with closing the streams.
if (((INVALID_HANDLE_VALUE != stdin_handle) && (stdin_handle == stdout_handle || stdin_handle == stderr_handle))
|| ((INVALID_HANDLE_VALUE != stdout_handle) && (stdout_handle == stdin_handle || stdout_handle == stderr_handle))
|| ((INVALID_HANDLE_VALUE != stderr_handle) && (stderr_handle == stdin_handle || stderr_handle == stdout_handle)))
{
return;
}
// Get the Windows I/O handles before we do anything.
hStdIn = GetStdHandle(STD_INPUT_HANDLE);
hStdOut = GetStdHandle(STD_OUTPUT_HANDLE);
hStdErr = GetStdHandle(STD_ERROR_HANDLE);
// At this point, we have confirmed that the I/O streams all have different
// handles, and we have the Windows standard I/O handles as well.
// Proceed with closing the streams.
fclose(stdin);
fclose(stdout);
// Now we need to close the Windows standard I/O handles, as they might
// differ from the handles for the C streams.
// First, make sure we don't close handles that we have already closed
// by closing the streams.
if (stdin_handle == hStdIn || stdout_handle == hStdIn)
{
SetStdHandle(STD_INPUT_HANDLE, NULL);
hStdIn = NULL;
}
if (stdin_handle == hStdOut || stdout_handle == hStdOut)
{
SetStdHandle(STD_OUTPUT_HANDLE, NULL);
hStdOut = NULL;
}
if (stdin_handle == hStdErr || stdout_handle == hStdErr)
{
SetStdHandle(STD_ERROR_HANDLE, NULL);
hStdErr = NULL;
}
// Ensure we don't accidentally close the standard error handle.
if (stderr_handle == hStdIn)
{
hStdIn = NULL;
}
if (stderr_handle == hStdOut)
{
hStdOut = NULL;
}
if (stderr_handle == hStdErr)
{
hStdErr = NULL;
}
// Close 'em.
if (NULL != hStdIn && INVALID_HANDLE_VALUE != hStdIn)
{
CloseHandle(hStdIn);
SetStdHandle(STD_INPUT_HANDLE, NULL);
}
if (NULL != hStdOut && INVALID_HANDLE_VALUE != hStdOut)
{
CloseHandle(hStdOut);
SetStdHandle(STD_OUTPUT_HANDLE, NULL);
}
if (NULL != hStdErr && INVALID_HANDLE_VALUE != hStdErr)
{
CloseHandle(hStdErr);
SetStdHandle(STD_ERROR_HANDLE, NULL);
}
}
#define SWITCH_WORKING_DIR
#if defined(SWITCH_WORKING_DIR)
/*
* Switch the working directory to the user's temp directory.
*/
static void
switch_working_directory() {
WCHAR tempDir[MAX_PATH + 1];
DWORD len = GetTempPathW(MAX_PATH + 1, tempDir);
if (len > 0 && len <= MAX_PATH) {
SetCurrentDirectoryW(tempDir);
}
}
#endif
/*
* Best-effort cleanup of file descriptors and handles after spawning the child
* process.
* See discussion starting from here: https://github.com/pypa/pip/issues/10444#issuecomment-1055392299
*/
static void
post_spawn_cleanup(WORD cbReserved2, LPBYTE lpReserved2)
{
cleanup_fds(cbReserved2, lpReserved2);
cleanup_standard_io();
#if defined(SWITCH_WORKING_DIR)
switch_working_directory();
#endif
}
/*
* See https://github.com/pypa/pip/issues/10444#issuecomment-971921420
*/
#define STARTF_UNDOC_MONITOR 0x400
/*
* See https://github.com/pypa/pip/issues/10444#issuecomment-973396812
*/
static void
run_child(wchar_t * cmdline)
{
DWORD rc;
BOOL ok;
STARTUPINFOW si;
job = CreateJobObject(NULL, NULL);
assert(job != NULL, "Job creation failed");
ok = QueryInformationJobObject(job, JobObjectExtendedLimitInformation,
&job_info, sizeof(job_info), &rc);
assert(ok && (rc == sizeof(job_info)), "Job information querying failed");
job_info.BasicLimitInformation.LimitFlags |= JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE |
JOB_OBJECT_LIMIT_SILENT_BREAKAWAY_OK;
ok = SetInformationJobObject(job, JobObjectExtendedLimitInformation, &job_info,
sizeof(job_info));
assert(ok, "Job information setting failed");
memset(&si, 0, sizeof(si));
GetStartupInfoW(&si);
/*
* See https://github.com/pypa/pip/issues/10444#issuecomment-973396812
*/
if ((si.dwFlags & (STARTF_USEHOTKEY | STARTF_UNDOC_MONITOR)) == 0) {
HANDLE hIn = GetStdHandle(STD_INPUT_HANDLE);
HANDLE hOut = GetStdHandle(STD_OUTPUT_HANDLE);
HANDLE hErr = GetStdHandle(STD_ERROR_HANDLE);
#if defined(DUPLICATE_HANDLES)
ok = safe_duplicate_handle(hIn, &si.hStdInput);
assert(ok, "stdin duplication failed");
CloseHandle(hIn);
ok = safe_duplicate_handle(hOut, &si.hStdOutput);
assert(ok, "stdout duplication failed");
CloseHandle(hOut);
/* We might need stderr late, so don't close it but mark as non-inheritable */
SetHandleInformation(hErr, HANDLE_FLAG_INHERIT, 0);
ok = safe_duplicate_handle(hErr, &si.hStdError);
assert(ok, "stderr duplication failed");
#else
/*
* See https://github.com/pypa/pip/issues/10444#issuecomment-1055392299
*/
ok = make_handle_inheritable(hIn);
assert(ok, "making stdin inheritable failed");
ok = make_handle_inheritable(hOut);
assert(ok, "making stdout inheritable failed");
ok = make_handle_inheritable(hErr);
assert(ok, "making stderr inheritable failed");
si.hStdInput = hIn;
si.hStdOutput = hOut;
si.hStdError = hErr;
#endif
si.dwFlags |= STARTF_USESTDHANDLES;
}
ok = CreateProcessW(NULL, cmdline, NULL, NULL, TRUE, 0, NULL, NULL, &si, &child_process_info);
if (!ok) {
// Failed to create process. See if we can find out why.
DWORD err = GetLastError();
wchar_t emessage[MSGSIZE];
FormatMessageW(FORMAT_MESSAGE_FROM_SYSTEM, NULL, err,
MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT), emessage, MSGSIZE, NULL);
wassert(ok, L"Unable to create process using '%ls': %ls", cmdline, emessage);
}
// Assign the process to the job straight away. See https://github.com/pypa/distlib/issues/175
AssignProcessToJobObject(job, child_process_info.hProcess);
post_spawn_cleanup(si.cbReserved2, si.lpReserved2);
/*
* Control handler setting is now done after process creation because the handler needs access
* to the child_process_info structure, which is populated by the CreateProcessW call above.
*/
ok = SetConsoleCtrlHandler((PHANDLER_ROUTINE) control_key_handler, TRUE);
assert(ok, "control handler setting failed");
#if !defined(_CONSOLE)
clear_app_starting_state(&child_process_info);
#endif
CloseHandle(child_process_info.hThread);
WaitForSingleObjectEx(child_process_info.hProcess, INFINITE, FALSE);
ok = GetExitCodeProcess(child_process_info.hProcess, &rc);
assert(ok, "Failed to get exit code of process");
ExitProcess(rc);
}
static wchar_t *
find_exe_extension(wchar_t * line) {
wchar_t * p;
while ((p = StrStrIW(line, L".exe")) != NULL) {
wchar_t c = p[4];
if ((c == L'\0') || (c == L'"') || iswspace(c))
break;
line = &p[4];
}
return p;
}
static wchar_t *
find_executable_and_args(wchar_t * line, wchar_t ** argp)
{
wchar_t * p = find_exe_extension(line);
#if defined(USE_ENVIRONMENT)
wchar_t * q;
int n;
#endif
wchar_t * result;
#if !defined(USE_ENVIRONMENT)
assert(p != NULL, "Expected to find a command ending in '.exe' in shebang line: %ls", line);
p += 4; /* skip past the '.exe' */
result = line;
#else
if (p != NULL) {
p += 4; /* skip past the '.exe' */
result = line;
}
else {
n = _wcsnicmp(line, L"/usr/bin/env", 12);
assert(n == 0, "Expected to find a command ending in '.exe' in shebang line: %ls", line);
p = line + 12; /* past the '/usr/bin/env' */
assert(*p && iswspace(*p), "Expected to find whitespace after '/usr/bin/env': %ls", line);
do {
++p;
} while (*p && iswspace(*p));
/* Now, p points to what comes after /usr/bin/env and any following whitespace. */
q = p;
/* Skip past executable name and NUL-terminate it. */
while (*q && !iswspace(*q))
++q;
if (iswspace(*q))
*q++ = L'\0';
result = find_environment_executable(p);
assert(result != NULL, "Unable to find executable in environment: %ls", line);
p = q; /* point past name of executable in shebang */
}
#endif
if (*line == L'"') {
assert(*p == L'"', "Expected terminating double-quote for executable in shebang line: %ls", line);
*p++ = L'\0';
++line;
++result; /* See https://bitbucket.org/pypa/distlib/issues/104 */
}
/* p points just past the executable. It must either be a NUL or whitespace. */
#if !defined(SUPPORT_RELATIVE_PATH)
assert(*p != L'"', "Terminating quote without starting quote for executable in shebang line: %ls", line);
#else
if (_wcsnicmp(line, RELATIVE_PREFIX, RELATIVE_PREFIX_LENGTH) && (line[RELATIVE_PREFIX_LENGTH] != L'\"')) {
assert(*p != L'"', "Terminating quote without starting quote for executable in shebang line: %ls", line);
}
#endif
/* if p is whitespace, make it NUL to truncate 'line', and advance */
if (*p && iswspace(*p))
*p++ = L'\0';
/* Now we can skip the whitespace, having checked that it's there. */
while(*p && iswspace(*p))
++p;
*argp = p;
return result;
}
static int
process(int argc, char * argv[])
{
wchar_t * cmdline = skip_me(GetCommandLineW());
wchar_t * psp;
size_t len = GetModuleFileNameW(NULL, script_path, MAX_PATH);
FILE *fp = NULL;
char buffer[MAX_PATH];
wchar_t wbuffer[MAX_PATH];
#if defined(SUPPORT_RELATIVE_PATH)
wchar_t dbuffer[MAX_PATH];
wchar_t pbuffer[MAX_PATH];
wchar_t * qp;
int prefix_offset;
#endif
char *cp;
wchar_t * wcp;
wchar_t * cmdp;
char * p;
wchar_t * wp;
int n;
#if !defined(APPENDED_ARCHIVE)
errno_t rc;
#endif
if (script_path[0] != L'\"')
psp = script_path;
else {
psp = &script_path[1];
len -= 2;
}
psp[len] = L'\0';
#if !defined(APPENDED_ARCHIVE)
/* Replace the .exe with -script.py(w) */
wp = wcsstr(psp, L".exe");
assert(wp != NULL, "Failed to find \".exe\" in executable name");
len = MAX_PATH - (wp - script_path);
assert(len > sizeof(suffix), "Failed to append \"%ls\" suffix", suffix);
wcsncpy_s(wp, len, suffix, sizeof(suffix));
#endif
#if defined(APPENDED_ARCHIVE)
/* Initialise signature dynamically so that it doesn't appear in
* a stock executable.
*/
end_cdr_sig[0] = 0x50;
p = find_shebang(buffer, MAX_PATH);
assert(p != NULL, "Failed to find shebang");
#else
rc = _wfopen_s(&fp, psp, L"rb");
assert(rc == 0, "Failed to open script file '%ls'", psp);
fread(buffer, sizeof(char), MAX_PATH, fp);
fclose(fp);
p = buffer;
#endif
cp = find_terminator(p, MAX_PATH);
assert(cp != NULL, "Expected to find terminator in shebang line");
*cp = '\0';
// Decode as UTF-8
n = MultiByteToWideChar(CP_UTF8, MB_ERR_INVALID_CHARS, p, (int) (cp - p), wbuffer, MAX_PATH);
assert(n != 0, "Expected to decode shebang line using UTF-8");
wbuffer[n] = L'\0';
wcp = wbuffer;
while (*wcp && iswspace(*wcp))
++wcp;
assert(*wcp == L'#', "Expected to find \'#\' at start of shebang line");
++wcp;
while (*wcp && iswspace(*wcp))
++wcp;
assert(*wcp == L'!', "Expected to find \'!\' following \'#\' in shebang line");
++wcp;
while (*wcp && iswspace(*wcp))
++wcp;
wp = NULL;
wcp = find_executable_and_args(wcp, &wp);
assert(wcp != NULL, "Expected to find executable in shebang line");
assert(wp != NULL, "Expected to find arguments (even if empty) in shebang line");
#if defined(SUPPORT_RELATIVE_PATH)
/*
If the executable starts with the relative prefix, resolve the following path
relative to the launcher's directory.
*/
prefix_offset = RELATIVE_PREFIX_LENGTH;
if (!_wcsnicmp(RELATIVE_PREFIX, wcp, prefix_offset)) {
wcscpy_s(dbuffer, MAX_PATH, script_path);
PathRemoveFileSpecW(dbuffer);
if (wcp[prefix_offset] == L'\"') {
prefix_offset++;
qp = wcschr(&wcp[prefix_offset], L'\"');
assert(qp != NULL, "Expected terminating double-quote for executable in shebang line: %ls", wcp);
*qp = L'\0';
}
// The following call appears to canonicalize the path, so no need to
// worry about doing that
PathCombineW(pbuffer, dbuffer, &wcp[prefix_offset]);
wcp = pbuffer;
}
#endif
/* 3 spaces + 4 quotes + NUL */
len = wcslen(wcp) + wcslen(wp) + 8 + wcslen(psp) + wcslen(cmdline);
cmdp = (wchar_t *) calloc(len, sizeof(wchar_t));
assert(cmdp != NULL, "Expected to be able to allocate command line memory");
_snwprintf_s(cmdp, len, len, L"\"%ls\" %ls \"%ls\" %ls", wcp, wp, psp, cmdline);
run_child(cmdp); /* never actually returns */
free(cmdp);
return 0;
}
#if defined(_CONSOLE)
int main(int argc, char* argv[])
{
return process(argc, argv);
}
#else
int APIENTRY WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
LPSTR lpCmdLine, int nCmdShow)
{
return process(__argc, __argv);
}
#endif
././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1554793251.0
distlib-0.4.3/PC/launcher.ico 0000644 0001750 0001750 00000046516 13453041443 015062 0 ustar 00vinay vinay v ( ^ h .
00 % >8 h H ( @ ... GGG WWW iii uuu ̀ ww ww|| ww wwww ww fwwwww|fwwwwwwffwwwwwwffwwwwwfflwwffffffwfffffflwffffffwffffff|ff ffff ff R\Ilffl )ff ح 2L 18 Ϥ" A< ΣTπ U ? ? ? ? ? ? ? ( 444 MMM SSS zzz p p {p{f fko f_fffk_fff[f}UUUfL4UUU_kJqO_~'[U_ U wwwww{ ~ ( @ %%% +++ 000 === AAA III MMM QQQ VVV YYY ]]] ~dF ggg jjj mmm rrr uuu }}} u? z= ~; gE kC oA r@ : I b p ƏK Уk ( , 1 ? 5 < \ C K Q s U [ c b ð / P p
=1 [Q yq / "P 0p = L Y g x 1 Q q &/ @P Zp t 1 Q q /& PA p[ t ϩ 1 Q q / P" p0 > M [ i y 1 Q q ұ / P p
>1 \Q zq / P p ! + 6 @ I Z 1p Q q / P 6 p L b x 1 Q q , / K P i p 1 Q q / - P ? p R c v 1 Q q ϑ ܱ / P p ! & , > X1 qQ q _______ CCBABAD L*(%$""&G ABJIIDDJC??AD_-(''%$GG#_ DIJIIJIIIDIJDD_+)(''%GG _ JMCEJ?ABAECA?BA_,+)('%%"!_ IM@AJACDCIDI____.,++>________ JMJJJJJJJJJF_..,+)('%$"! #G IMCEJJJI?J_ _...,+(('%$"! &_ JM?AJJJJCJ__...,+)(''%$" _ IMJJJJJJJJ_K=...,++(''%$! _ JMCDJJJJAJ_ K_______L*%$"!_ I_?AMNJJEJ_ L'%$"_ I_MMMMMMJJ_ _('%%_ I_CEMIJJMEM _(''*_ I_?BMDJEMDMF _)(-L I_MMMCMMMMM_________< ____ I_CEM1;MACDMEJM__ I_?A_D1@IJJMJMM_FF_ I__6_@/EMMMNMM_ FF _ I_C80EJDMJCJF F ?:AA20?_M_MIEM______M IC4BC/
N______MMMMJIDA I_9/ HJJMMJMMMJ??BA I_A7503 IJMMCBCBA44CC I___BAO;6___C_MJIDIDM I_CI___O;
@__C_C?J?AJ I_?A_DJJI@ O_CM?;I?J I_________H9MAIJJIJ I_CD_____JJI73C;IJIJ I_?AMDJJDIMJIE5:JIJ I__________MMIA:IJ JJJJJJJJJJJJJJJMJ ? ? ?( 444 MMM RRR YYY ~eG uuu }}} x> iE rC E ~ 7 ? H V b x /! P7 pL c y Ϗ 1 Q q / P p" , 6 @ J [ 1q Q q / P p
=1 [Q yq / "P 0p = L Y g x 1 Q q &/ @P Zp t 1 Q q /& PA p[ t ϩ 1 Q q / P" p0 > M [ i y 1 Q q ұ / P p
>1 \Q zq / P p ! + 6 @ I Z 1p Q q / P 6 p L b x 1 Q q , / K P i p 1 Q q / - P ? p R c v 1 Q q ϑ ܱ / P p ! & , > X1 qQ q ! %///* !* / "(%%'%/)
/ !#''/// /+/+ "*(/
/
!%(/
(
(*/ (///)
*/
)*
/ "///// /+ /// #
+ !% //
+ "*+ '#+//+' !%*++$++!+! !!! < ( 0 ` ! ! $ & & "
WܱNj+<<:5pi$ !!!4 888&SNJFB=950,( %%%5ǎVRNIE ѹ|Jq?o@ZUQMID@<73/+&"- Ɍ444"ք̴wq?]YUPLHC?;72.*%! """4 888&dya\XTPKGC>:61-)% O Ñ%%%5ʎA{;ys`\WSOJFB>951,($( 9|:z;xq?o@mAkBiCgCdDuZ;73.* Ǒ%%%5̎È>89}:{;yq?o@mAjBhCfD~dEuZ?:625 Оa789}:{;yr>p?n@lAjBhCfD}dEB>:5^ ό555"܄ѳ7789}:{;xr?p@n@lAjBgCeDFA=9 """4 ;;;&ŌC89~9|:z;xr?p@mAkAiBgCIEL ɑQQQJnnn~~~Įq?o@mAkBiC HHH"""vvv9~:{;yq?o@mAkB :::'''___sssttt8Ϧuǣvyp?n@lA 888T ---6fffnddd%%%"""OOOSSSċDҧuʤv{;yr?p?xM <<r?̷ 999VVV###)))444ѳ͝b@~9|:z;}Cg˶Ӎ ZZZlll;;;!!!""")))___&&&2 :::ppp{{{___WWWWWW:::!!!"""***www"""4 888& , ̑999ԖJJJ|||lll:::"""BBBXXX|||$$$6 , uuuKKKCCC@@@...www * Ҍ666"KKKaaaLLLWWW@ $ """4 ;;;&nnnfff!!!$$$999444]ttt|ȇ ɑ&&&5ЎvvvmmmVVV{{{OOOڥ aaaCCCppp ό555"ބ|||MMMfff """4 ;;;&\\\ Ǒ%%%5Ύݧ ܦ ͌555"ۄۥ """4 :::&ڤ Ñ%%%5ˎܤ ׇ
ww ?ww ??ww ?ww ?ww ?ww ?ww ?ww ?ww ?ww ?ww ?ww ?ww ww ww ww ww ww ww ww ww ww ww ww ww ww ?ww ?ww ?ww ?ww ?ww ?ww ?ww ?ww ?ww ?ww ?ww ww ww ww ww ww ww ww ?ww ww ww ww( @ !!!0\\\JeeeQ666D555A 0 $
vH<602\ 7qڴvvvj&&&D 1 "gLF@;5? кVQKE?9( aV[UPJD>82- uuun{{{j`ZTO Vo@lAb_YSMGB<60+%< aVmt>q?n@bb^XRLFA;5/)$Y wwwn}}}j~Cv=s>p?bba]WQKE@:4.(+ {;xbba[VPJD?93-' aV~:{;xr?o@lAiBfD}dE|cE|cEiB<61 ?9}:z;w=t>q?n@kAiCfD}cE|cE}dFGA;= aVңi89|:yq?n@kBhCeD|cE|cELF@m zzznjʓP8~9{;yp?mAjBgCeD|cEPJ\ ¯mAjBgC~dE aV}:z;xq?n@lAiC JJJőPyq?n@~Y VVV???wwwiiiΡkA|;y>>3@@@y~~~obbb000kkk@@@ ---U<<<&&&[[[ 6 uuusssWWWIII$$$&&&qqqlllg|||s 4 bbbhhhƑUUU000QQQ}}}---{bbb ( iiiLLLBBB aVggg+++NNN |||nj]]]tttkkk rrrwwwӦ aVӦ zzznjӦ ˉ ? ? ? ? ?( C o I ਨS=? _QF4 aZмoEcaXMB70~Iq?c`VK@58z;u=qv>3Eyn@iB~dE}dFGHYYYuuuġ=xmAhC}dE}eGS444|||gC}cEMMM~>q?kAiG RRR¢Gu=xKʺ ~AA A A A A A A A A A A A A A A ././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1554793251.0
distlib-0.4.3/PC/launcher.rc 0000644 0001750 0001750 00000000124 13453041443 014675 0 ustar 00vinay vinay #define IDI_ICON 101
LANGUAGE 0, 0
IDI_ICON ICON ".\\launcher.ico"
././@PaxHeader 0000000 0000000 0000000 00000000034 00000000000 010212 x ustar 00 28 mtime=1781251341.5235376
distlib-0.4.3/PKG-INFO 0000644 0001750 0001750 00000012305 15212736416 013353 0 ustar 00vinay vinay Metadata-Version: 2.4
Name: distlib
Version: 0.4.3
Summary: Distribution utilities
Home-page: https://github.com/pypa/distlib
Author: Vinay Sajip
Author-email: vinay_sajip@red-dove.com
License: PSF-2.0
Project-URL: Documentation, https://distlib.readthedocs.io/
Project-URL: Source, https://github.com/pypa/distlib
Project-URL: Tracker, https://github.com/pypa/distlib/issues
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Python Software Foundation License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development
License-File: LICENSE.txt
Dynamic: license-file
|badge1| |badge2|
.. |badge1| image:: https://img.shields.io/github/actions/workflow/status/pypa/distlib/package-tests.yml
:alt: GitHub Workflow Status (with event)
.. |badge2| image:: https://img.shields.io/codecov/c/github/pypa/distlib
:target: https://app.codecov.io/gh/pypa/distlib
:alt: GitHub coverage status
What is it?
-----------
Distlib is a library which implements low-level functions that relate to
packaging and distribution of Python software. It is intended to be used as the
basis for third-party packaging tools. The documentation is available at
https://distlib.readthedocs.io/
Main features
-------------
Distlib currently offers the following features:
* The package ``distlib.database``, which implements a database of installed
distributions, as defined by :pep:`376`, and distribution dependency graph
logic. Support is also provided for non-installed distributions (i.e.
distributions registered with metadata on an index like PyPI), including
the ability to scan for dependencies and building dependency graphs.
* The package ``distlib.index``, which implements an interface to perform
operations on an index, such as registering a project, uploading a
distribution or uploading documentation. Support is included for verifying
SSL connections (with domain matching) and signing/verifying packages using
GnuPG.
* The package ``distlib.metadata``, which implements distribution metadata as
defined by :pep:`643`, :pep:`566`, :pep:`345`, :pep:`314` and :pep:`241`.
* The package ``distlib.markers``, which implements environment markers as
defined by :pep:`508`.
* The package ``distlib.manifest``, which implements lists of files used
in packaging source distributions.
* The package ``distlib.locators``, which allows finding distributions, whether
on PyPI (XML-RPC or via the "simple" interface), local directories or some
other source.
* The package ``distlib.resources``, which allows access to data files stored
in Python packages, both in the file system and in .zip files.
* The package ``distlib.scripts``, which allows installing of scripts with
adjustment of shebang lines and support for native Windows executable
launchers.
* The package ``distlib.version``, which implements version specifiers as
defined by :pep:`440`, but also support for working with "legacy" versions and
semantic versions.
* The package ``distlib.wheel``, which provides support for building and
installing from the Wheel format for binary distributions (see :pep:`427`).
* The package ``distlib.util``, which contains miscellaneous functions and
classes which are useful in packaging, but which do not fit neatly into
one of the other packages in ``distlib``.* The package implements enhanced
globbing functionality such as the ability to use ``**`` in patterns to
specify recursing into subdirectories.
Python version and platform compatibility
-----------------------------------------
Distlib is intended to be used on and is tested on Python versions 2.7 and 3.6 or later,
pypy-2.7 and pypy3 on Linux, Windows, and macOS.
Project status
--------------
The project has reached a mature status in its development: there is a comprehensive
test suite and it has been exercised on Windows, Ubuntu and macOS. The project is used
by well-known projects such as `pip `_ and `caniusepython3
`_.
This project was migrated from Mercurial to Git and from BitBucket to GitHub, and
although all information of importance has been retained across the migration, some
commit references in issues and issue comments may have become invalid.
Code of Conduct
---------------
Everyone interacting in the distlib project's codebases, issue trackers, chat
rooms, and mailing lists is expected to follow the `PyPA Code of Conduct`_.
.. _PyPA Code of Conduct: https://www.pypa.io/en/latest/code-of-conduct/
././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1689589485.0
distlib-0.4.3/README.rst 0000664 0001750 0001750 00000007540 14455213355 013754 0 ustar 00vinay vinay |badge1| |badge2|
.. |badge1| image:: https://img.shields.io/github/actions/workflow/status/pypa/distlib/package-tests.yml
:alt: GitHub Workflow Status (with event)
.. |badge2| image:: https://img.shields.io/codecov/c/github/pypa/distlib
:target: https://app.codecov.io/gh/pypa/distlib
:alt: GitHub coverage status
What is it?
-----------
Distlib is a library which implements low-level functions that relate to
packaging and distribution of Python software. It is intended to be used as the
basis for third-party packaging tools. The documentation is available at
https://distlib.readthedocs.io/
Main features
-------------
Distlib currently offers the following features:
* The package ``distlib.database``, which implements a database of installed
distributions, as defined by :pep:`376`, and distribution dependency graph
logic. Support is also provided for non-installed distributions (i.e.
distributions registered with metadata on an index like PyPI), including
the ability to scan for dependencies and building dependency graphs.
* The package ``distlib.index``, which implements an interface to perform
operations on an index, such as registering a project, uploading a
distribution or uploading documentation. Support is included for verifying
SSL connections (with domain matching) and signing/verifying packages using
GnuPG.
* The package ``distlib.metadata``, which implements distribution metadata as
defined by :pep:`643`, :pep:`566`, :pep:`345`, :pep:`314` and :pep:`241`.
* The package ``distlib.markers``, which implements environment markers as
defined by :pep:`508`.
* The package ``distlib.manifest``, which implements lists of files used
in packaging source distributions.
* The package ``distlib.locators``, which allows finding distributions, whether
on PyPI (XML-RPC or via the "simple" interface), local directories or some
other source.
* The package ``distlib.resources``, which allows access to data files stored
in Python packages, both in the file system and in .zip files.
* The package ``distlib.scripts``, which allows installing of scripts with
adjustment of shebang lines and support for native Windows executable
launchers.
* The package ``distlib.version``, which implements version specifiers as
defined by :pep:`440`, but also support for working with "legacy" versions and
semantic versions.
* The package ``distlib.wheel``, which provides support for building and
installing from the Wheel format for binary distributions (see :pep:`427`).
* The package ``distlib.util``, which contains miscellaneous functions and
classes which are useful in packaging, but which do not fit neatly into
one of the other packages in ``distlib``.* The package implements enhanced
globbing functionality such as the ability to use ``**`` in patterns to
specify recursing into subdirectories.
Python version and platform compatibility
-----------------------------------------
Distlib is intended to be used on and is tested on Python versions 2.7 and 3.6 or later,
pypy-2.7 and pypy3 on Linux, Windows, and macOS.
Project status
--------------
The project has reached a mature status in its development: there is a comprehensive
test suite and it has been exercised on Windows, Ubuntu and macOS. The project is used
by well-known projects such as `pip `_ and `caniusepython3
`_.
This project was migrated from Mercurial to Git and from BitBucket to GitHub, and
although all information of importance has been retained across the migration, some
commit references in issues and issue comments may have become invalid.
Code of Conduct
---------------
Everyone interacting in the distlib project's codebases, issue trackers, chat
rooms, and mailing lists is expected to follow the `PyPA Code of Conduct`_.
.. _PyPA Code of Conduct: https://www.pypa.io/en/latest/code-of-conduct/
././@PaxHeader 0000000 0000000 0000000 00000000034 00000000000 010212 x ustar 00 28 mtime=1781251341.5035336
distlib-0.4.3/distlib/ 0000775 0001750 0001750 00000000000 15212736416 013711 5 ustar 00vinay vinay ././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1781251035.0
distlib-0.4.3/distlib/__init__.py 0000644 0001750 0001750 00000001161 15212735733 016020 0 ustar 00vinay vinay # -*- coding: utf-8 -*-
#
# Copyright (C) 2012-2024 Vinay Sajip.
# Licensed to the Python Software Foundation under a contributor agreement.
# See LICENSE.txt and CONTRIBUTORS.txt.
#
import logging
__version__ = '0.4.3'
class DistlibException(Exception):
pass
try:
from logging import NullHandler
except ImportError: # pragma: no cover
class NullHandler(logging.Handler):
def handle(self, record):
pass
def emit(self, record):
pass
def createLock(self):
self.lock = None
logger = logging.getLogger(__name__)
logger.addHandler(NullHandler())
././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1780933749.0
distlib-0.4.3/distlib/compat.py 0000644 0001750 0001750 00000117235 15211562165 015552 0 ustar 00vinay vinay # -*- coding: utf-8 -*-
#
# Copyright (C) 2013-2026 Vinay Sajip.
# Licensed to the Python Software Foundation under a contributor agreement.
# See LICENSE.txt and CONTRIBUTORS.txt.
#
from __future__ import absolute_import
import os
import re
import shutil
import sys
try:
import ssl
except ImportError: # pragma: no cover
ssl = None
if sys.version_info[0] < 3: # pragma: no cover
from StringIO import StringIO
string_types = basestring,
text_type = unicode
from types import FileType as file_type
import __builtin__ as builtins
import ConfigParser as configparser
from urlparse import urlparse, urlunparse, urljoin, urlsplit, urlunsplit
from urllib import (urlretrieve, quote as _quote, unquote, url2pathname, pathname2url, ContentTooShortError,
splittype)
def quote(s):
if isinstance(s, unicode):
s = s.encode('utf-8')
return _quote(s)
import urllib2
from urllib2 import (Request, urlopen, URLError, HTTPError, HTTPBasicAuthHandler, HTTPPasswordMgr, HTTPHandler,
HTTPRedirectHandler, build_opener)
if ssl:
from urllib2 import HTTPSHandler
import httplib
import xmlrpclib
import Queue as queue
from HTMLParser import HTMLParser
import htmlentitydefs
raw_input = raw_input
from itertools import ifilter as filter
from itertools import ifilterfalse as filterfalse
# Leaving this around for now, in case it needs resurrecting in some way
# _userprog = None
# def splituser(host):
# """splituser('user[:passwd]@host[:port]') --> 'user[:passwd]', 'host[:port]'."""
# global _userprog
# if _userprog is None:
# import re
# _userprog = re.compile('^(.*)@(.*)$')
# match = _userprog.match(host)
# if match: return match.group(1, 2)
# return None, host
else: # pragma: no cover
from io import StringIO
string_types = str,
text_type = str
from io import TextIOWrapper as file_type
import builtins
import configparser
from urllib.parse import (urlparse, urlunparse, urljoin, quote, unquote, urlsplit, urlunsplit, splittype)
from urllib.request import (urlopen, urlretrieve, Request, url2pathname, pathname2url, HTTPBasicAuthHandler,
HTTPPasswordMgr, HTTPHandler, HTTPRedirectHandler, build_opener)
if ssl:
from urllib.request import HTTPSHandler
from urllib.error import HTTPError, URLError, ContentTooShortError
import http.client as httplib
import urllib.request as urllib2
import xmlrpc.client as xmlrpclib
import queue
from html.parser import HTMLParser
import html.entities as htmlentitydefs
raw_input = input
from itertools import filterfalse
filter = filter
try:
from ssl import match_hostname, CertificateError
except ImportError: # pragma: no cover
class CertificateError(ValueError):
pass
def _dnsname_match(dn, hostname, max_wildcards=1):
"""Matching according to RFC 6125, section 6.4.3
http://tools.ietf.org/html/rfc6125#section-6.4.3
"""
pats = []
if not dn:
return False
parts = dn.split('.')
leftmost, remainder = parts[0], parts[1:]
wildcards = leftmost.count('*')
if wildcards > max_wildcards:
# Issue #17980: avoid denials of service by refusing more
# than one wildcard per fragment. A survey of established
# policy among SSL implementations showed it to be a
# reasonable choice.
raise CertificateError('Too many wildcards in certificate DNS name: %r' % dn)
# speed up common case w/o wildcards
if not wildcards:
return dn.lower() == hostname.lower()
# RFC 6125, section 6.4.3, subitem 1.
# The client SHOULD NOT attempt to match a presented identifier in which
# the wildcard character comprises a label other than the left-most label.
if leftmost == '*':
# When '*' is a fragment by itself, it matches a non-empty dotless
# fragment.
pats.append('[^.]+')
elif leftmost.startswith('xn--') or hostname.startswith('xn--'):
# RFC 6125, section 6.4.3, subitem 3.
# The client SHOULD NOT attempt to match a presented identifier
# where the wildcard character is embedded within an A-label or
# U-label of an internationalized domain name.
pats.append(re.escape(leftmost))
else:
# Otherwise, '*' matches any dotless string, e.g. www*
pats.append(re.escape(leftmost).replace(r'\*', '[^.]*'))
# add the remaining fragments, ignore any wildcards
for frag in remainder:
pats.append(re.escape(frag))
pat = re.compile(r'\A' + r'\.'.join(pats) + r'\Z', re.IGNORECASE)
return pat.match(hostname)
def match_hostname(cert, hostname):
"""Verify that *cert* (in decoded format as returned by
SSLSocket.getpeercert()) matches the *hostname*. RFC 2818 and RFC 6125
rules are followed, but IP addresses are not accepted for *hostname*.
CertificateError is raised on failure. On success, the function
returns nothing.
"""
if not cert:
raise ValueError("empty or no certificate, match_hostname needs a "
"SSL socket or SSL context with either "
"CERT_OPTIONAL or CERT_REQUIRED")
dnsnames = []
san = cert.get('subjectAltName', ())
for key, value in san:
if key == 'DNS':
if _dnsname_match(value, hostname):
return
dnsnames.append(value)
if not dnsnames:
# The subject is only checked when there is no dNSName entry
# in subjectAltName
for sub in cert.get('subject', ()):
for key, value in sub:
# XXX according to RFC 2818, the most specific Common Name
# must be used.
if key == 'commonName':
if _dnsname_match(value, hostname):
return
dnsnames.append(value)
if len(dnsnames) > 1:
raise CertificateError("hostname %r "
"doesn't match either of %s" % (hostname, ', '.join(map(repr, dnsnames))))
elif len(dnsnames) == 1:
raise CertificateError("hostname %r "
"doesn't match %r" % (hostname, dnsnames[0]))
else:
raise CertificateError("no appropriate commonName or "
"subjectAltName fields were found")
try:
from types import SimpleNamespace as Container
except ImportError: # pragma: no cover
class Container(object):
"""
A generic container for when multiple values need to be returned
"""
def __init__(self, **kwargs):
self.__dict__.update(kwargs)
try:
from shutil import which
except ImportError: # pragma: no cover
# Implementation from Python 3.3
def which(cmd, mode=os.F_OK | os.X_OK, path=None):
"""Given a command, mode, and a PATH string, return the path which
conforms to the given mode on the PATH, or None if there is no such
file.
`mode` defaults to os.F_OK | os.X_OK. `path` defaults to the result
of os.environ.get("PATH"), or can be overridden with a custom search
path.
"""
# Check that a given file can be accessed with the correct mode.
# Additionally check that `file` is not a directory, as on Windows
# directories pass the os.access check.
def _access_check(fn, mode):
return (os.path.exists(fn) and os.access(fn, mode) and not os.path.isdir(fn))
# If we're given a path with a directory part, look it up directly rather
# than referring to PATH directories. This includes checking relative to the
# current directory, e.g. ./script
if os.path.dirname(cmd):
if _access_check(cmd, mode):
return cmd
return None
if path is None:
path = os.environ.get("PATH", os.defpath)
if not path:
return None
path = path.split(os.pathsep)
if sys.platform == "win32":
# The current directory takes precedence on Windows.
if os.curdir not in path:
path.insert(0, os.curdir)
# PATHEXT is necessary to check on Windows.
pathext = os.environ.get("PATHEXT", "").split(os.pathsep)
# See if the given file matches any of the expected path extensions.
# This will allow us to short circuit when given "python.exe".
# If it does match, only test that one, otherwise we have to try
# others.
if any(cmd.lower().endswith(ext.lower()) for ext in pathext):
files = [cmd]
else:
files = [cmd + ext for ext in pathext]
else:
# On other platforms you don't have things like PATHEXT to tell you
# what file suffixes are executable, so just pass on cmd as-is.
files = [cmd]
seen = set()
for dir in path:
normdir = os.path.normcase(dir)
if normdir not in seen:
seen.add(normdir)
for thefile in files:
name = os.path.join(dir, thefile)
if _access_check(name, mode):
return name
return None
# ZipFile is a context manager in 2.7, but not in 2.6
from zipfile import ZipFile as BaseZipFile
if hasattr(BaseZipFile, '__enter__'): # pragma: no cover
ZipFile = BaseZipFile
else: # pragma: no cover
from zipfile import ZipExtFile as BaseZipExtFile
class ZipExtFile(BaseZipExtFile):
def __init__(self, base):
self.__dict__.update(base.__dict__)
def __enter__(self):
return self
def __exit__(self, *exc_info):
self.close()
# return None, so if an exception occurred, it will propagate
class ZipFile(BaseZipFile):
def __enter__(self):
return self
def __exit__(self, *exc_info):
self.close()
# return None, so if an exception occurred, it will propagate
def open(self, *args, **kwargs):
base = BaseZipFile.open(self, *args, **kwargs)
return ZipExtFile(base)
try:
from platform import python_implementation
except ImportError: # pragma: no cover
def python_implementation():
"""Return a string identifying the Python implementation."""
if 'PyPy' in sys.version:
return 'PyPy'
if os.name == 'java':
return 'Jython'
if sys.version.startswith('IronPython'):
return 'IronPython'
return 'CPython'
import sysconfig
try:
callable = callable
except NameError: # pragma: no cover
from collections.abc import Callable
def callable(obj):
return isinstance(obj, Callable)
try:
fsencode = os.fsencode
fsdecode = os.fsdecode
except AttributeError: # pragma: no cover
# Issue #99: on some systems (e.g. containerised),
# sys.getfilesystemencoding() returns None, and we need a real value,
# so fall back to utf-8. From the CPython 2.7 docs relating to Unix and
# sys.getfilesystemencoding(): the return value is "the user’s preference
# according to the result of nl_langinfo(CODESET), or None if the
# nl_langinfo(CODESET) failed."
_fsencoding = sys.getfilesystemencoding() or 'utf-8'
if _fsencoding == 'mbcs':
_fserrors = 'strict'
else:
_fserrors = 'surrogateescape'
def fsencode(filename):
if isinstance(filename, bytes):
return filename
elif isinstance(filename, text_type):
return filename.encode(_fsencoding, _fserrors)
else:
raise TypeError("expect bytes or str, not %s" % type(filename).__name__)
def fsdecode(filename):
if isinstance(filename, text_type):
return filename
elif isinstance(filename, bytes):
return filename.decode(_fsencoding, _fserrors)
else:
raise TypeError("expect bytes or str, not %s" % type(filename).__name__)
try:
from tokenize import detect_encoding
except ImportError: # pragma: no cover
from codecs import BOM_UTF8, lookup
cookie_re = re.compile(r"coding[:=]\s*([-\w.]+)")
def _get_normal_name(orig_enc):
"""Imitates get_normal_name in tokenizer.c."""
# Only care about the first 12 characters.
enc = orig_enc[:12].lower().replace("_", "-")
if enc == "utf-8" or enc.startswith("utf-8-"):
return "utf-8"
if enc in ("latin-1", "iso-8859-1", "iso-latin-1") or \
enc.startswith(("latin-1-", "iso-8859-1-", "iso-latin-1-")):
return "iso-8859-1"
return orig_enc
def detect_encoding(readline):
"""
The detect_encoding() function is used to detect the encoding that should
be used to decode a Python source file. It requires one argument, readline,
in the same way as the tokenize() generator.
It will call readline a maximum of twice, and return the encoding used
(as a string) and a list of any lines (left as bytes) it has read in.
It detects the encoding from the presence of a utf-8 bom or an encoding
cookie as specified in pep-0263. If both a bom and a cookie are present,
but disagree, a SyntaxError will be raised. If the encoding cookie is an
invalid charset, raise a SyntaxError. Note that if a utf-8 bom is found,
'utf-8-sig' is returned.
If no encoding is specified, then the default of 'utf-8' will be returned.
"""
try:
filename = readline.__self__.name
except AttributeError:
filename = None
bom_found = False
encoding = None
default = 'utf-8'
def read_or_stop():
try:
return readline()
except StopIteration:
return b''
def find_cookie(line):
try:
# Decode as UTF-8. Either the line is an encoding declaration,
# in which case it should be pure ASCII, or it must be UTF-8
# per default encoding.
line_string = line.decode('utf-8')
except UnicodeDecodeError:
msg = "invalid or missing encoding declaration"
if filename is not None:
msg = '{} for {!r}'.format(msg, filename)
raise SyntaxError(msg)
matches = cookie_re.findall(line_string)
if not matches:
return None
encoding = _get_normal_name(matches[0])
try:
codec = lookup(encoding)
except LookupError:
# This behaviour mimics the Python interpreter
if filename is None:
msg = "unknown encoding: " + encoding
else:
msg = "unknown encoding for {!r}: {}".format(filename, encoding)
raise SyntaxError(msg)
if bom_found:
if codec.name != 'utf-8':
# This behaviour mimics the Python interpreter
if filename is None:
msg = 'Encoding problem: utf-8'
else:
msg = 'Encoding problem for %r: utf-8' % filename
raise SyntaxError(msg)
encoding += '-sig'
return encoding
first = read_or_stop()
if first.startswith(BOM_UTF8):
bom_found = True
first = first[3:]
default = 'utf-8-sig'
if not first:
return default, []
encoding = find_cookie(first)
if encoding:
return encoding, [first]
second = read_or_stop()
if not second:
return default, [first]
encoding = find_cookie(second)
if encoding:
return encoding, [first, second]
return default, [first, second]
# For converting & <-> & etc.
try:
from html import escape
except ImportError:
from cgi import escape
if sys.version_info[:2] < (3, 4):
unescape = HTMLParser().unescape
else:
from html import unescape
try:
from collections import ChainMap
except ImportError: # pragma: no cover
from collections import MutableMapping
try:
from reprlib import recursive_repr as _recursive_repr
except ImportError:
def _recursive_repr(fillvalue='...'):
'''
Decorator to make a repr function return fillvalue for a recursive
call
'''
def decorating_function(user_function):
repr_running = set()
def wrapper(self):
key = id(self), get_ident()
if key in repr_running:
return fillvalue
repr_running.add(key)
try:
result = user_function(self)
finally:
repr_running.discard(key)
return result
# Can't use functools.wraps() here because of bootstrap issues
wrapper.__module__ = getattr(user_function, '__module__')
wrapper.__doc__ = getattr(user_function, '__doc__')
wrapper.__name__ = getattr(user_function, '__name__')
wrapper.__annotations__ = getattr(user_function, '__annotations__', {})
return wrapper
return decorating_function
class ChainMap(MutableMapping):
'''
A ChainMap groups multiple dicts (or other mappings) together
to create a single, updateable view.
The underlying mappings are stored in a list. That list is public and can
accessed or updated using the *maps* attribute. There is no other state.
Lookups search the underlying mappings successively until a key is found.
In contrast, writes, updates, and deletions only operate on the first
mapping.
'''
def __init__(self, *maps):
'''Initialize a ChainMap by setting *maps* to the given mappings.
If no mappings are provided, a single empty dictionary is used.
'''
self.maps = list(maps) or [{}] # always at least one map
def __missing__(self, key):
raise KeyError(key)
def __getitem__(self, key):
for mapping in self.maps:
try:
return mapping[key] # can't use 'key in mapping' with defaultdict
except KeyError:
pass
return self.__missing__(key) # support subclasses that define __missing__
def get(self, key, default=None):
return self[key] if key in self else default
def __len__(self):
return len(set().union(*self.maps)) # reuses stored hash values if possible
def __iter__(self):
return iter(set().union(*self.maps))
def __contains__(self, key):
return any(key in m for m in self.maps)
def __bool__(self):
return any(self.maps)
@_recursive_repr()
def __repr__(self):
return '{0.__class__.__name__}({1})'.format(self, ', '.join(map(repr, self.maps)))
@classmethod
def fromkeys(cls, iterable, *args):
'Create a ChainMap with a single dict created from the iterable.'
return cls(dict.fromkeys(iterable, *args))
def copy(self):
'New ChainMap or subclass with a new copy of maps[0] and refs to maps[1:]'
return self.__class__(self.maps[0].copy(), *self.maps[1:])
__copy__ = copy
def new_child(self): # like Django's Context.push()
'New ChainMap with a new dict followed by all previous maps.'
return self.__class__({}, *self.maps)
@property
def parents(self): # like Django's Context.pop()
'New ChainMap from maps[1:].'
return self.__class__(*self.maps[1:])
def __setitem__(self, key, value):
self.maps[0][key] = value
def __delitem__(self, key):
try:
del self.maps[0][key]
except KeyError:
raise KeyError('Key not found in the first mapping: {!r}'.format(key))
def popitem(self):
'Remove and return an item pair from maps[0]. Raise KeyError is maps[0] is empty.'
try:
return self.maps[0].popitem()
except KeyError:
raise KeyError('No keys found in the first mapping.')
def pop(self, key, *args):
'Remove *key* from maps[0] and return its value. Raise KeyError if *key* not in maps[0].'
try:
return self.maps[0].pop(key, *args)
except KeyError:
raise KeyError('Key not found in the first mapping: {!r}'.format(key))
def clear(self):
'Clear maps[0], leaving maps[1:] intact.'
self.maps[0].clear()
try:
from importlib.util import cache_from_source # Python >= 3.4
except ImportError: # pragma: no cover
def cache_from_source(path, debug_override=None, optimization=None):
assert path.endswith('.py')
if debug_override is None:
debug_override = __debug__
if debug_override:
suffix = 'c'
else:
suffix = 'o'
return path + suffix
try:
from collections import OrderedDict
except ImportError: # pragma: no cover
# {{{ http://code.activestate.com/recipes/576693/ (r9)
# Backport of OrderedDict() class that runs on Python 2.4, 2.5, 2.6, 2.7 and pypy.
# Passes Python2.7's test suite and incorporates all the latest updates.
try:
from thread import get_ident as _get_ident
except ImportError:
from dummy_thread import get_ident as _get_ident
try:
from _abcoll import KeysView, ValuesView, ItemsView
except ImportError:
pass
class OrderedDict(dict):
'Dictionary that remembers insertion order'
# An inherited dict maps keys to values.
# The inherited dict provides __getitem__, __len__, __contains__, and get.
# The remaining methods are order-aware.
# Big-O running times for all methods are the same as for regular dictionaries.
# The internal self.__map dictionary maps keys to links in a doubly linked list.
# The circular doubly linked list starts and ends with a sentinel element.
# The sentinel element never gets deleted (this simplifies the algorithm).
# Each link is stored as a list of length three: [PREV, NEXT, KEY].
def __init__(self, *args, **kwds):
'''Initialize an ordered dictionary. Signature is the same as for
regular dictionaries, but keyword arguments are not recommended
because their insertion order is arbitrary.
'''
if len(args) > 1:
raise TypeError('expected at most 1 arguments, got %d' % len(args))
try:
self.__root
except AttributeError:
self.__root = root = [] # sentinel node
root[:] = [root, root, None]
self.__map = {}
self.__update(*args, **kwds)
def __setitem__(self, key, value, dict_setitem=dict.__setitem__):
'od.__setitem__(i, y) <==> od[i]=y'
# Setting a new item creates a new link which goes at the end of the linked
# list, and the inherited dictionary is updated with the new key/value pair.
if key not in self:
root = self.__root
last = root[0]
last[1] = root[0] = self.__map[key] = [last, root, key]
dict_setitem(self, key, value)
def __delitem__(self, key, dict_delitem=dict.__delitem__):
'od.__delitem__(y) <==> del od[y]'
# Deleting an existing item uses self.__map to find the link which is
# then removed by updating the links in the predecessor and successor nodes.
dict_delitem(self, key)
link_prev, link_next, key = self.__map.pop(key)
link_prev[1] = link_next
link_next[0] = link_prev
def __iter__(self):
'od.__iter__() <==> iter(od)'
root = self.__root
curr = root[1]
while curr is not root:
yield curr[2]
curr = curr[1]
def __reversed__(self):
'od.__reversed__() <==> reversed(od)'
root = self.__root
curr = root[0]
while curr is not root:
yield curr[2]
curr = curr[0]
def clear(self):
'od.clear() -> None. Remove all items from od.'
try:
for node in self.__map.itervalues():
del node[:]
root = self.__root
root[:] = [root, root, None]
self.__map.clear()
except AttributeError:
pass
dict.clear(self)
def popitem(self, last=True):
'''od.popitem() -> (k, v), return and remove a (key, value) pair.
Pairs are returned in LIFO order if last is true or FIFO order if false.
'''
if not self:
raise KeyError('dictionary is empty')
root = self.__root
if last:
link = root[0]
link_prev = link[0]
link_prev[1] = root
root[0] = link_prev
else:
link = root[1]
link_next = link[1]
root[1] = link_next
link_next[0] = root
key = link[2]
del self.__map[key]
value = dict.pop(self, key)
return key, value
# -- the following methods do not depend on the internal structure --
def keys(self):
'od.keys() -> list of keys in od'
return list(self)
def values(self):
'od.values() -> list of values in od'
return [self[key] for key in self]
def items(self):
'od.items() -> list of (key, value) pairs in od'
return [(key, self[key]) for key in self]
def iterkeys(self):
'od.iterkeys() -> an iterator over the keys in od'
return iter(self)
def itervalues(self):
'od.itervalues -> an iterator over the values in od'
for k in self:
yield self[k]
def iteritems(self):
'od.iteritems -> an iterator over the (key, value) items in od'
for k in self:
yield (k, self[k])
def update(*args, **kwds):
'''od.update(E, **F) -> None. Update od from dict/iterable E and F.
If E is a dict instance, does: for k in E: od[k] = E[k]
If E has a .keys() method, does: for k in E.keys(): od[k] = E[k]
Or if E is an iterable of items, does: for k, v in E: od[k] = v
In either case, this is followed by: for k, v in F.items(): od[k] = v
'''
if len(args) > 2:
raise TypeError('update() takes at most 2 positional '
'arguments (%d given)' % (len(args), ))
elif not args:
raise TypeError('update() takes at least 1 argument (0 given)')
self = args[0]
# Make progressively weaker assumptions about "other"
other = ()
if len(args) == 2:
other = args[1]
if isinstance(other, dict):
for key in other:
self[key] = other[key]
elif hasattr(other, 'keys'):
for key in other.keys():
self[key] = other[key]
else:
for key, value in other:
self[key] = value
for key, value in kwds.items():
self[key] = value
__update = update # let subclasses override update without breaking __init__
__marker = object()
def pop(self, key, default=__marker):
'''od.pop(k[,d]) -> v, remove specified key and return the corresponding value.
If key is not found, d is returned if given, otherwise KeyError is raised.
'''
if key in self:
result = self[key]
del self[key]
return result
if default is self.__marker:
raise KeyError(key)
return default
def setdefault(self, key, default=None):
'od.setdefault(k[,d]) -> od.get(k,d), also set od[k]=d if k not in od'
if key in self:
return self[key]
self[key] = default
return default
def __repr__(self, _repr_running=None):
'od.__repr__() <==> repr(od)'
if not _repr_running:
_repr_running = {}
call_key = id(self), _get_ident()
if call_key in _repr_running:
return '...'
_repr_running[call_key] = 1
try:
if not self:
return '%s()' % (self.__class__.__name__, )
return '%s(%r)' % (self.__class__.__name__, self.items())
finally:
del _repr_running[call_key]
def __reduce__(self):
'Return state information for pickling'
items = [[k, self[k]] for k in self]
inst_dict = vars(self).copy()
for k in vars(OrderedDict()):
inst_dict.pop(k, None)
if inst_dict:
return (self.__class__, (items, ), inst_dict)
return self.__class__, (items, )
def copy(self):
'od.copy() -> a shallow copy of od'
return self.__class__(self)
@classmethod
def fromkeys(cls, iterable, value=None):
'''OD.fromkeys(S[, v]) -> New ordered dictionary with keys from S
and values equal to v (which defaults to None).
'''
d = cls()
for key in iterable:
d[key] = value
return d
def __eq__(self, other):
'''od.__eq__(y) <==> od==y. Comparison to another OD is order-sensitive
while comparison to a regular mapping is order-insensitive.
'''
if isinstance(other, OrderedDict):
return len(self) == len(other) and self.items() == other.items()
return dict.__eq__(self, other)
def __ne__(self, other):
return not self == other
# -- the following methods are only used in Python 2.7 --
def viewkeys(self):
"od.viewkeys() -> a set-like object providing a view on od's keys"
return KeysView(self)
def viewvalues(self):
"od.viewvalues() -> an object providing a view on od's values"
return ValuesView(self)
def viewitems(self):
"od.viewitems() -> a set-like object providing a view on od's items"
return ItemsView(self)
try:
from logging.config import BaseConfigurator, valid_ident
except ImportError: # pragma: no cover
IDENTIFIER = re.compile('^[a-z_][a-z0-9_]*$', re.I)
def valid_ident(s):
m = IDENTIFIER.match(s)
if not m:
raise ValueError('Not a valid Python identifier: %r' % s)
return True
# The ConvertingXXX classes are wrappers around standard Python containers,
# and they serve to convert any suitable values in the container. The
# conversion converts base dicts, lists and tuples to their wrapped
# equivalents, whereas strings which match a conversion format are converted
# appropriately.
#
# Each wrapper should have a configurator attribute holding the actual
# configurator to use for conversion.
class ConvertingDict(dict):
"""A converting dictionary wrapper."""
def __getitem__(self, key):
value = dict.__getitem__(self, key)
result = self.configurator.convert(value)
# If the converted value is different, save for next time
if value is not result:
self[key] = result
if type(result) in (ConvertingDict, ConvertingList, ConvertingTuple):
result.parent = self
result.key = key
return result
def get(self, key, default=None):
value = dict.get(self, key, default)
result = self.configurator.convert(value)
# If the converted value is different, save for next time
if value is not result:
self[key] = result
if type(result) in (ConvertingDict, ConvertingList, ConvertingTuple):
result.parent = self
result.key = key
return result
def pop(self, key, default=None):
value = dict.pop(self, key, default)
result = self.configurator.convert(value)
if value is not result:
if type(result) in (ConvertingDict, ConvertingList, ConvertingTuple):
result.parent = self
result.key = key
return result
class ConvertingList(list):
"""A converting list wrapper."""
def __getitem__(self, key):
value = list.__getitem__(self, key)
result = self.configurator.convert(value)
# If the converted value is different, save for next time
if value is not result:
self[key] = result
if type(result) in (ConvertingDict, ConvertingList, ConvertingTuple):
result.parent = self
result.key = key
return result
def pop(self, idx=-1):
value = list.pop(self, idx)
result = self.configurator.convert(value)
if value is not result:
if type(result) in (ConvertingDict, ConvertingList, ConvertingTuple):
result.parent = self
return result
class ConvertingTuple(tuple):
"""A converting tuple wrapper."""
def __getitem__(self, key):
value = tuple.__getitem__(self, key)
result = self.configurator.convert(value)
if value is not result:
if type(result) in (ConvertingDict, ConvertingList, ConvertingTuple):
result.parent = self
result.key = key
return result
class BaseConfigurator(object):
"""
The configurator base class which defines some useful defaults.
"""
CONVERT_PATTERN = re.compile(r'^(?P[a-z]+)://(?P.*)$')
WORD_PATTERN = re.compile(r'^\s*(\w+)\s*')
DOT_PATTERN = re.compile(r'^\.\s*(\w+)\s*')
INDEX_PATTERN = re.compile(r'^\[\s*(\w+)\s*\]\s*')
DIGIT_PATTERN = re.compile(r'^\d+$')
value_converters = {
'ext': 'ext_convert',
'cfg': 'cfg_convert',
}
# We might want to use a different one, e.g. importlib
importer = staticmethod(__import__)
def __init__(self, config):
self.config = ConvertingDict(config)
self.config.configurator = self
def resolve(self, s):
"""
Resolve strings to objects using standard import and attribute
syntax.
"""
name = s.split('.')
used = name.pop(0)
try:
found = self.importer(used)
for frag in name:
used += '.' + frag
try:
found = getattr(found, frag)
except AttributeError:
self.importer(used)
found = getattr(found, frag)
return found
except ImportError:
e, tb = sys.exc_info()[1:]
v = ValueError('Cannot resolve %r: %s' % (s, e))
v.__cause__, v.__traceback__ = e, tb
raise v
def ext_convert(self, value):
"""Default converter for the ext:// protocol."""
return self.resolve(value)
def cfg_convert(self, value):
"""Default converter for the cfg:// protocol."""
rest = value
m = self.WORD_PATTERN.match(rest)
if m is None:
raise ValueError("Unable to convert %r" % value)
else:
rest = rest[m.end():]
d = self.config[m.groups()[0]]
while rest:
m = self.DOT_PATTERN.match(rest)
if m:
d = d[m.groups()[0]]
else:
m = self.INDEX_PATTERN.match(rest)
if m:
idx = m.groups()[0]
if not self.DIGIT_PATTERN.match(idx):
d = d[idx]
else:
try:
n = int(idx) # try as number first (most likely)
d = d[n]
except TypeError:
d = d[idx]
if m:
rest = rest[m.end():]
else:
raise ValueError('Unable to convert '
'%r at %r' % (value, rest))
# rest should be empty
return d
def convert(self, value):
"""
Convert values to an appropriate type. dicts, lists and tuples are
replaced by their converting alternatives. Strings are checked to
see if they have a conversion format and are converted if they do.
"""
if not isinstance(value, ConvertingDict) and isinstance(value, dict):
value = ConvertingDict(value)
value.configurator = self
elif not isinstance(value, ConvertingList) and isinstance(value, list):
value = ConvertingList(value)
value.configurator = self
elif not isinstance(value, ConvertingTuple) and isinstance(value, tuple):
value = ConvertingTuple(value)
value.configurator = self
elif isinstance(value, string_types):
m = self.CONVERT_PATTERN.match(value)
if m:
d = m.groupdict()
prefix = d['prefix']
converter = self.value_converters.get(prefix, None)
if converter:
suffix = d['suffix']
converter = getattr(self, converter)
value = converter(suffix)
return value
def configure_custom(self, config):
"""Configure an object with a user-supplied factory."""
c = config.pop('()')
if not callable(c):
c = self.resolve(c)
props = config.pop('.', None)
# Check for valid identifiers
kwargs = dict([(k, config[k]) for k in config if valid_ident(k)])
result = c(**kwargs)
if props:
for name, value in props.items():
setattr(result, name, value)
return result
def as_tuple(self, value):
"""Utility function which converts lists to tuples."""
if isinstance(value, list):
value = tuple(value)
return value
././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1710843576.0
distlib-0.4.3/distlib/database.py 0000664 0001750 0001750 00000143730 14576263270 016044 0 ustar 00vinay vinay # -*- coding: utf-8 -*-
#
# Copyright (C) 2012-2023 The Python Software Foundation.
# See LICENSE.txt and CONTRIBUTORS.txt.
#
"""PEP 376 implementation."""
from __future__ import unicode_literals
import base64
import codecs
import contextlib
import hashlib
import logging
import os
import posixpath
import sys
import zipimport
from . import DistlibException, resources
from .compat import StringIO
from .version import get_scheme, UnsupportedVersionError
from .metadata import (Metadata, METADATA_FILENAME, WHEEL_METADATA_FILENAME, LEGACY_METADATA_FILENAME)
from .util import (parse_requirement, cached_property, parse_name_and_version, read_exports, write_exports, CSVReader,
CSVWriter)
__all__ = [
'Distribution', 'BaseInstalledDistribution', 'InstalledDistribution', 'EggInfoDistribution', 'DistributionPath'
]
logger = logging.getLogger(__name__)
EXPORTS_FILENAME = 'pydist-exports.json'
COMMANDS_FILENAME = 'pydist-commands.json'
DIST_FILES = ('INSTALLER', METADATA_FILENAME, 'RECORD', 'REQUESTED', 'RESOURCES', EXPORTS_FILENAME, 'SHARED')
DISTINFO_EXT = '.dist-info'
class _Cache(object):
"""
A simple cache mapping names and .dist-info paths to distributions
"""
def __init__(self):
"""
Initialise an instance. There is normally one for each DistributionPath.
"""
self.name = {}
self.path = {}
self.generated = False
def clear(self):
"""
Clear the cache, setting it to its initial state.
"""
self.name.clear()
self.path.clear()
self.generated = False
def add(self, dist):
"""
Add a distribution to the cache.
:param dist: The distribution to add.
"""
if dist.path not in self.path:
self.path[dist.path] = dist
self.name.setdefault(dist.key, []).append(dist)
class DistributionPath(object):
"""
Represents a set of distributions installed on a path (typically sys.path).
"""
def __init__(self, path=None, include_egg=False):
"""
Create an instance from a path, optionally including legacy (distutils/
setuptools/distribute) distributions.
:param path: The path to use, as a list of directories. If not specified,
sys.path is used.
:param include_egg: If True, this instance will look for and return legacy
distributions as well as those based on PEP 376.
"""
if path is None:
path = sys.path
self.path = path
self._include_dist = True
self._include_egg = include_egg
self._cache = _Cache()
self._cache_egg = _Cache()
self._cache_enabled = True
self._scheme = get_scheme('default')
def _get_cache_enabled(self):
return self._cache_enabled
def _set_cache_enabled(self, value):
self._cache_enabled = value
cache_enabled = property(_get_cache_enabled, _set_cache_enabled)
def clear_cache(self):
"""
Clears the internal cache.
"""
self._cache.clear()
self._cache_egg.clear()
def _yield_distributions(self):
"""
Yield .dist-info and/or .egg(-info) distributions.
"""
# We need to check if we've seen some resources already, because on
# some Linux systems (e.g. some Debian/Ubuntu variants) there are
# symlinks which alias other files in the environment.
seen = set()
for path in self.path:
finder = resources.finder_for_path(path)
if finder is None:
continue
r = finder.find('')
if not r or not r.is_container:
continue
rset = sorted(r.resources)
for entry in rset:
r = finder.find(entry)
if not r or r.path in seen:
continue
try:
if self._include_dist and entry.endswith(DISTINFO_EXT):
possible_filenames = [METADATA_FILENAME, WHEEL_METADATA_FILENAME, LEGACY_METADATA_FILENAME]
for metadata_filename in possible_filenames:
metadata_path = posixpath.join(entry, metadata_filename)
pydist = finder.find(metadata_path)
if pydist:
break
else:
continue
with contextlib.closing(pydist.as_stream()) as stream:
metadata = Metadata(fileobj=stream, scheme='legacy')
logger.debug('Found %s', r.path)
seen.add(r.path)
yield new_dist_class(r.path, metadata=metadata, env=self)
elif self._include_egg and entry.endswith(('.egg-info', '.egg')):
logger.debug('Found %s', r.path)
seen.add(r.path)
yield old_dist_class(r.path, self)
except Exception as e:
msg = 'Unable to read distribution at %s, perhaps due to bad metadata: %s'
logger.warning(msg, r.path, e)
import warnings
warnings.warn(msg % (r.path, e), stacklevel=2)
def _generate_cache(self):
"""
Scan the path for distributions and populate the cache with
those that are found.
"""
gen_dist = not self._cache.generated
gen_egg = self._include_egg and not self._cache_egg.generated
if gen_dist or gen_egg:
for dist in self._yield_distributions():
if isinstance(dist, InstalledDistribution):
self._cache.add(dist)
else:
self._cache_egg.add(dist)
if gen_dist:
self._cache.generated = True
if gen_egg:
self._cache_egg.generated = True
@classmethod
def distinfo_dirname(cls, name, version):
"""
The *name* and *version* parameters are converted into their
filename-escaped form, i.e. any ``'-'`` characters are replaced
with ``'_'`` other than the one in ``'dist-info'`` and the one
separating the name from the version number.
:parameter name: is converted to a standard distribution name by replacing
any runs of non- alphanumeric characters with a single
``'-'``.
:type name: string
:parameter version: is converted to a standard version string. Spaces
become dots, and all other non-alphanumeric characters
(except dots) become dashes, with runs of multiple
dashes condensed to a single dash.
:type version: string
:returns: directory name
:rtype: string"""
name = name.replace('-', '_')
return '-'.join([name, version]) + DISTINFO_EXT
def get_distributions(self):
"""
Provides an iterator that looks for distributions and returns
:class:`InstalledDistribution` or
:class:`EggInfoDistribution` instances for each one of them.
:rtype: iterator of :class:`InstalledDistribution` and
:class:`EggInfoDistribution` instances
"""
if not self._cache_enabled:
for dist in self._yield_distributions():
yield dist
else:
self._generate_cache()
for dist in self._cache.path.values():
yield dist
if self._include_egg:
for dist in self._cache_egg.path.values():
yield dist
def get_distribution(self, name):
"""
Looks for a named distribution on the path.
This function only returns the first result found, as no more than one
value is expected. If nothing is found, ``None`` is returned.
:rtype: :class:`InstalledDistribution`, :class:`EggInfoDistribution`
or ``None``
"""
result = None
name = name.lower()
if not self._cache_enabled:
for dist in self._yield_distributions():
if dist.key == name:
result = dist
break
else:
self._generate_cache()
if name in self._cache.name:
result = self._cache.name[name][0]
elif self._include_egg and name in self._cache_egg.name:
result = self._cache_egg.name[name][0]
return result
def provides_distribution(self, name, version=None):
"""
Iterates over all distributions to find which distributions provide *name*.
If a *version* is provided, it will be used to filter the results.
This function only returns the first result found, since no more than
one values are expected. If the directory is not found, returns ``None``.
:parameter version: a version specifier that indicates the version
required, conforming to the format in ``PEP-345``
:type name: string
:type version: string
"""
matcher = None
if version is not None:
try:
matcher = self._scheme.matcher('%s (%s)' % (name, version))
except ValueError:
raise DistlibException('invalid name or version: %r, %r' % (name, version))
for dist in self.get_distributions():
# We hit a problem on Travis where enum34 was installed and doesn't
# have a provides attribute ...
if not hasattr(dist, 'provides'):
logger.debug('No "provides": %s', dist)
else:
provided = dist.provides
for p in provided:
p_name, p_ver = parse_name_and_version(p)
if matcher is None:
if p_name == name:
yield dist
break
else:
if p_name == name and matcher.match(p_ver):
yield dist
break
def get_file_path(self, name, relative_path):
"""
Return the path to a resource file.
"""
dist = self.get_distribution(name)
if dist is None:
raise LookupError('no distribution named %r found' % name)
return dist.get_resource_path(relative_path)
def get_exported_entries(self, category, name=None):
"""
Return all of the exported entries in a particular category.
:param category: The category to search for entries.
:param name: If specified, only entries with that name are returned.
"""
for dist in self.get_distributions():
r = dist.exports
if category in r:
d = r[category]
if name is not None:
if name in d:
yield d[name]
else:
for v in d.values():
yield v
class Distribution(object):
"""
A base class for distributions, whether installed or from indexes.
Either way, it must have some metadata, so that's all that's needed
for construction.
"""
build_time_dependency = False
"""
Set to True if it's known to be only a build-time dependency (i.e.
not needed after installation).
"""
requested = False
"""A boolean that indicates whether the ``REQUESTED`` metadata file is
present (in other words, whether the package was installed by user
request or it was installed as a dependency)."""
def __init__(self, metadata):
"""
Initialise an instance.
:param metadata: The instance of :class:`Metadata` describing this
distribution.
"""
self.metadata = metadata
self.name = metadata.name
self.key = self.name.lower() # for case-insensitive comparisons
self.version = metadata.version
self.locator = None
self.digest = None
self.extras = None # additional features requested
self.context = None # environment marker overrides
self.download_urls = set()
self.digests = {}
@property
def source_url(self):
"""
The source archive download URL for this distribution.
"""
return self.metadata.source_url
download_url = source_url # Backward compatibility
@property
def name_and_version(self):
"""
A utility property which displays the name and version in parentheses.
"""
return '%s (%s)' % (self.name, self.version)
@property
def provides(self):
"""
A set of distribution names and versions provided by this distribution.
:return: A set of "name (version)" strings.
"""
plist = self.metadata.provides
s = '%s (%s)' % (self.name, self.version)
if s not in plist:
plist.append(s)
return plist
def _get_requirements(self, req_attr):
md = self.metadata
reqts = getattr(md, req_attr)
logger.debug('%s: got requirements %r from metadata: %r', self.name, req_attr, reqts)
return set(md.get_requirements(reqts, extras=self.extras, env=self.context))
@property
def run_requires(self):
return self._get_requirements('run_requires')
@property
def meta_requires(self):
return self._get_requirements('meta_requires')
@property
def build_requires(self):
return self._get_requirements('build_requires')
@property
def test_requires(self):
return self._get_requirements('test_requires')
@property
def dev_requires(self):
return self._get_requirements('dev_requires')
def matches_requirement(self, req):
"""
Say if this instance matches (fulfills) a requirement.
:param req: The requirement to match.
:rtype req: str
:return: True if it matches, else False.
"""
# Requirement may contain extras - parse to lose those
# from what's passed to the matcher
r = parse_requirement(req)
scheme = get_scheme(self.metadata.scheme)
try:
matcher = scheme.matcher(r.requirement)
except UnsupportedVersionError:
# XXX compat-mode if cannot read the version
logger.warning('could not read version %r - using name only', req)
name = req.split()[0]
matcher = scheme.matcher(name)
name = matcher.key # case-insensitive
result = False
for p in self.provides:
p_name, p_ver = parse_name_and_version(p)
if p_name != name:
continue
try:
result = matcher.match(p_ver)
break
except UnsupportedVersionError:
pass
return result
def __repr__(self):
"""
Return a textual representation of this instance,
"""
if self.source_url:
suffix = ' [%s]' % self.source_url
else:
suffix = ''
return '' % (self.name, self.version, suffix)
def __eq__(self, other):
"""
See if this distribution is the same as another.
:param other: The distribution to compare with. To be equal to one
another. distributions must have the same type, name,
version and source_url.
:return: True if it is the same, else False.
"""
if type(other) is not type(self):
result = False
else:
result = (self.name == other.name and self.version == other.version and self.source_url == other.source_url)
return result
def __hash__(self):
"""
Compute hash in a way which matches the equality test.
"""
return hash(self.name) + hash(self.version) + hash(self.source_url)
class BaseInstalledDistribution(Distribution):
"""
This is the base class for installed distributions (whether PEP 376 or
legacy).
"""
hasher = None
def __init__(self, metadata, path, env=None):
"""
Initialise an instance.
:param metadata: An instance of :class:`Metadata` which describes the
distribution. This will normally have been initialised
from a metadata file in the ``path``.
:param path: The path of the ``.dist-info`` or ``.egg-info``
directory for the distribution.
:param env: This is normally the :class:`DistributionPath`
instance where this distribution was found.
"""
super(BaseInstalledDistribution, self).__init__(metadata)
self.path = path
self.dist_path = env
def get_hash(self, data, hasher=None):
"""
Get the hash of some data, using a particular hash algorithm, if
specified.
:param data: The data to be hashed.
:type data: bytes
:param hasher: The name of a hash implementation, supported by hashlib,
or ``None``. Examples of valid values are ``'sha1'``,
``'sha224'``, ``'sha384'``, '``sha256'``, ``'md5'`` and
``'sha512'``. If no hasher is specified, the ``hasher``
attribute of the :class:`InstalledDistribution` instance
is used. If the hasher is determined to be ``None``, MD5
is used as the hashing algorithm.
:returns: The hash of the data. If a hasher was explicitly specified,
the returned hash will be prefixed with the specified hasher
followed by '='.
:rtype: str
"""
if hasher is None:
hasher = self.hasher
if hasher is None:
hasher = hashlib.md5
prefix = ''
else:
hasher = getattr(hashlib, hasher)
prefix = '%s=' % self.hasher
digest = hasher(data).digest()
digest = base64.urlsafe_b64encode(digest).rstrip(b'=').decode('ascii')
return '%s%s' % (prefix, digest)
class InstalledDistribution(BaseInstalledDistribution):
"""
Created with the *path* of the ``.dist-info`` directory provided to the
constructor. It reads the metadata contained in ``pydist.json`` when it is
instantiated., or uses a passed in Metadata instance (useful for when
dry-run mode is being used).
"""
hasher = 'sha256'
def __init__(self, path, metadata=None, env=None):
self.modules = []
self.finder = finder = resources.finder_for_path(path)
if finder is None:
raise ValueError('finder unavailable for %s' % path)
if env and env._cache_enabled and path in env._cache.path:
metadata = env._cache.path[path].metadata
elif metadata is None:
r = finder.find(METADATA_FILENAME)
# Temporary - for Wheel 0.23 support
if r is None:
r = finder.find(WHEEL_METADATA_FILENAME)
# Temporary - for legacy support
if r is None:
r = finder.find(LEGACY_METADATA_FILENAME)
if r is None:
raise ValueError('no %s found in %s' % (METADATA_FILENAME, path))
with contextlib.closing(r.as_stream()) as stream:
metadata = Metadata(fileobj=stream, scheme='legacy')
super(InstalledDistribution, self).__init__(metadata, path, env)
if env and env._cache_enabled:
env._cache.add(self)
r = finder.find('REQUESTED')
self.requested = r is not None
p = os.path.join(path, 'top_level.txt')
if os.path.exists(p):
with open(p, 'rb') as f:
data = f.read().decode('utf-8')
self.modules = data.splitlines()
def __repr__(self):
return '' % (self.name, self.version, self.path)
def __str__(self):
return "%s %s" % (self.name, self.version)
def _get_records(self):
"""
Get the list of installed files for the distribution
:return: A list of tuples of path, hash and size. Note that hash and
size might be ``None`` for some entries. The path is exactly
as stored in the file (which is as in PEP 376).
"""
results = []
r = self.get_distinfo_resource('RECORD')
with contextlib.closing(r.as_stream()) as stream:
with CSVReader(stream=stream) as record_reader:
# Base location is parent dir of .dist-info dir
# base_location = os.path.dirname(self.path)
# base_location = os.path.abspath(base_location)
for row in record_reader:
missing = [None for i in range(len(row), 3)]
path, checksum, size = row + missing
# if not os.path.isabs(path):
# path = path.replace('/', os.sep)
# path = os.path.join(base_location, path)
results.append((path, checksum, size))
return results
@cached_property
def exports(self):
"""
Return the information exported by this distribution.
:return: A dictionary of exports, mapping an export category to a dict
of :class:`ExportEntry` instances describing the individual
export entries, and keyed by name.
"""
result = {}
r = self.get_distinfo_resource(EXPORTS_FILENAME)
if r:
result = self.read_exports()
return result
def read_exports(self):
"""
Read exports data from a file in .ini format.
:return: A dictionary of exports, mapping an export category to a list
of :class:`ExportEntry` instances describing the individual
export entries.
"""
result = {}
r = self.get_distinfo_resource(EXPORTS_FILENAME)
if r:
with contextlib.closing(r.as_stream()) as stream:
result = read_exports(stream)
return result
def write_exports(self, exports):
"""
Write a dictionary of exports to a file in .ini format.
:param exports: A dictionary of exports, mapping an export category to
a list of :class:`ExportEntry` instances describing the
individual export entries.
"""
rf = self.get_distinfo_file(EXPORTS_FILENAME)
with open(rf, 'w') as f:
write_exports(exports, f)
def get_resource_path(self, relative_path):
"""
NOTE: This API may change in the future.
Return the absolute path to a resource file with the given relative
path.
:param relative_path: The path, relative to .dist-info, of the resource
of interest.
:return: The absolute path where the resource is to be found.
"""
r = self.get_distinfo_resource('RESOURCES')
with contextlib.closing(r.as_stream()) as stream:
with CSVReader(stream=stream) as resources_reader:
for relative, destination in resources_reader:
if relative == relative_path:
return destination
raise KeyError('no resource file with relative path %r '
'is installed' % relative_path)
def list_installed_files(self):
"""
Iterates over the ``RECORD`` entries and returns a tuple
``(path, hash, size)`` for each line.
:returns: iterator of (path, hash, size)
"""
for result in self._get_records():
yield result
def write_installed_files(self, paths, prefix, dry_run=False):
"""
Writes the ``RECORD`` file, using the ``paths`` iterable passed in. Any
existing ``RECORD`` file is silently overwritten.
prefix is used to determine when to write absolute paths.
"""
prefix = os.path.join(prefix, '')
base = os.path.dirname(self.path)
base_under_prefix = base.startswith(prefix)
base = os.path.join(base, '')
record_path = self.get_distinfo_file('RECORD')
logger.info('creating %s', record_path)
if dry_run:
return None
with CSVWriter(record_path) as writer:
for path in paths:
if os.path.isdir(path) or path.endswith(('.pyc', '.pyo')):
# do not put size and hash, as in PEP-376
hash_value = size = ''
else:
size = '%d' % os.path.getsize(path)
with open(path, 'rb') as fp:
hash_value = self.get_hash(fp.read())
if path.startswith(base) or (base_under_prefix and path.startswith(prefix)):
path = os.path.relpath(path, base)
writer.writerow((path, hash_value, size))
# add the RECORD file itself
if record_path.startswith(base):
record_path = os.path.relpath(record_path, base)
writer.writerow((record_path, '', ''))
return record_path
def check_installed_files(self):
"""
Checks that the hashes and sizes of the files in ``RECORD`` are
matched by the files themselves. Returns a (possibly empty) list of
mismatches. Each entry in the mismatch list will be a tuple consisting
of the path, 'exists', 'size' or 'hash' according to what didn't match
(existence is checked first, then size, then hash), the expected
value and the actual value.
"""
mismatches = []
base = os.path.dirname(self.path)
record_path = self.get_distinfo_file('RECORD')
for path, hash_value, size in self.list_installed_files():
if not os.path.isabs(path):
path = os.path.join(base, path)
if path == record_path:
continue
if not os.path.exists(path):
mismatches.append((path, 'exists', True, False))
elif os.path.isfile(path):
actual_size = str(os.path.getsize(path))
if size and actual_size != size:
mismatches.append((path, 'size', size, actual_size))
elif hash_value:
if '=' in hash_value:
hasher = hash_value.split('=', 1)[0]
else:
hasher = None
with open(path, 'rb') as f:
actual_hash = self.get_hash(f.read(), hasher)
if actual_hash != hash_value:
mismatches.append((path, 'hash', hash_value, actual_hash))
return mismatches
@cached_property
def shared_locations(self):
"""
A dictionary of shared locations whose keys are in the set 'prefix',
'purelib', 'platlib', 'scripts', 'headers', 'data' and 'namespace'.
The corresponding value is the absolute path of that category for
this distribution, and takes into account any paths selected by the
user at installation time (e.g. via command-line arguments). In the
case of the 'namespace' key, this would be a list of absolute paths
for the roots of namespace packages in this distribution.
The first time this property is accessed, the relevant information is
read from the SHARED file in the .dist-info directory.
"""
result = {}
shared_path = os.path.join(self.path, 'SHARED')
if os.path.isfile(shared_path):
with codecs.open(shared_path, 'r', encoding='utf-8') as f:
lines = f.read().splitlines()
for line in lines:
key, value = line.split('=', 1)
if key == 'namespace':
result.setdefault(key, []).append(value)
else:
result[key] = value
return result
def write_shared_locations(self, paths, dry_run=False):
"""
Write shared location information to the SHARED file in .dist-info.
:param paths: A dictionary as described in the documentation for
:meth:`shared_locations`.
:param dry_run: If True, the action is logged but no file is actually
written.
:return: The path of the file written to.
"""
shared_path = os.path.join(self.path, 'SHARED')
logger.info('creating %s', shared_path)
if dry_run:
return None
lines = []
for key in ('prefix', 'lib', 'headers', 'scripts', 'data'):
path = paths[key]
if os.path.isdir(paths[key]):
lines.append('%s=%s' % (key, path))
for ns in paths.get('namespace', ()):
lines.append('namespace=%s' % ns)
with codecs.open(shared_path, 'w', encoding='utf-8') as f:
f.write('\n'.join(lines))
return shared_path
def get_distinfo_resource(self, path):
if path not in DIST_FILES:
raise DistlibException('invalid path for a dist-info file: '
'%r at %r' % (path, self.path))
finder = resources.finder_for_path(self.path)
if finder is None:
raise DistlibException('Unable to get a finder for %s' % self.path)
return finder.find(path)
def get_distinfo_file(self, path):
"""
Returns a path located under the ``.dist-info`` directory. Returns a
string representing the path.
:parameter path: a ``'/'``-separated path relative to the
``.dist-info`` directory or an absolute path;
If *path* is an absolute path and doesn't start
with the ``.dist-info`` directory path,
a :class:`DistlibException` is raised
:type path: str
:rtype: str
"""
# Check if it is an absolute path # XXX use relpath, add tests
if path.find(os.sep) >= 0:
# it's an absolute path?
distinfo_dirname, path = path.split(os.sep)[-2:]
if distinfo_dirname != self.path.split(os.sep)[-1]:
raise DistlibException('dist-info file %r does not belong to the %r %s '
'distribution' % (path, self.name, self.version))
# The file must be relative
if path not in DIST_FILES:
raise DistlibException('invalid path for a dist-info file: '
'%r at %r' % (path, self.path))
return os.path.join(self.path, path)
def list_distinfo_files(self):
"""
Iterates over the ``RECORD`` entries and returns paths for each line if
the path is pointing to a file located in the ``.dist-info`` directory
or one of its subdirectories.
:returns: iterator of paths
"""
base = os.path.dirname(self.path)
for path, checksum, size in self._get_records():
# XXX add separator or use real relpath algo
if not os.path.isabs(path):
path = os.path.join(base, path)
if path.startswith(self.path):
yield path
def __eq__(self, other):
return (isinstance(other, InstalledDistribution) and self.path == other.path)
# See http://docs.python.org/reference/datamodel#object.__hash__
__hash__ = object.__hash__
class EggInfoDistribution(BaseInstalledDistribution):
"""Created with the *path* of the ``.egg-info`` directory or file provided
to the constructor. It reads the metadata contained in the file itself, or
if the given path happens to be a directory, the metadata is read from the
file ``PKG-INFO`` under that directory."""
requested = True # as we have no way of knowing, assume it was
shared_locations = {}
def __init__(self, path, env=None):
def set_name_and_version(s, n, v):
s.name = n
s.key = n.lower() # for case-insensitive comparisons
s.version = v
self.path = path
self.dist_path = env
if env and env._cache_enabled and path in env._cache_egg.path:
metadata = env._cache_egg.path[path].metadata
set_name_and_version(self, metadata.name, metadata.version)
else:
metadata = self._get_metadata(path)
# Need to be set before caching
set_name_and_version(self, metadata.name, metadata.version)
if env and env._cache_enabled:
env._cache_egg.add(self)
super(EggInfoDistribution, self).__init__(metadata, path, env)
def _get_metadata(self, path):
requires = None
def parse_requires_data(data):
"""Create a list of dependencies from a requires.txt file.
*data*: the contents of a setuptools-produced requires.txt file.
"""
reqs = []
lines = data.splitlines()
for line in lines:
line = line.strip()
# sectioned files have bare newlines (separating sections)
if not line: # pragma: no cover
continue
if line.startswith('['): # pragma: no cover
logger.warning('Unexpected line: quitting requirement scan: %r', line)
break
r = parse_requirement(line)
if not r: # pragma: no cover
logger.warning('Not recognised as a requirement: %r', line)
continue
if r.extras: # pragma: no cover
logger.warning('extra requirements in requires.txt are '
'not supported')
if not r.constraints:
reqs.append(r.name)
else:
cons = ', '.join('%s%s' % c for c in r.constraints)
reqs.append('%s (%s)' % (r.name, cons))
return reqs
def parse_requires_path(req_path):
"""Create a list of dependencies from a requires.txt file.
*req_path*: the path to a setuptools-produced requires.txt file.
"""
reqs = []
try:
with codecs.open(req_path, 'r', 'utf-8') as fp:
reqs = parse_requires_data(fp.read())
except IOError:
pass
return reqs
tl_path = tl_data = None
if path.endswith('.egg'):
if os.path.isdir(path):
p = os.path.join(path, 'EGG-INFO')
meta_path = os.path.join(p, 'PKG-INFO')
metadata = Metadata(path=meta_path, scheme='legacy')
req_path = os.path.join(p, 'requires.txt')
tl_path = os.path.join(p, 'top_level.txt')
requires = parse_requires_path(req_path)
else:
# FIXME handle the case where zipfile is not available
zipf = zipimport.zipimporter(path)
fileobj = StringIO(zipf.get_data('EGG-INFO/PKG-INFO').decode('utf8'))
metadata = Metadata(fileobj=fileobj, scheme='legacy')
try:
data = zipf.get_data('EGG-INFO/requires.txt')
tl_data = zipf.get_data('EGG-INFO/top_level.txt').decode('utf-8')
requires = parse_requires_data(data.decode('utf-8'))
except IOError:
requires = None
elif path.endswith('.egg-info'):
if os.path.isdir(path):
req_path = os.path.join(path, 'requires.txt')
requires = parse_requires_path(req_path)
path = os.path.join(path, 'PKG-INFO')
tl_path = os.path.join(path, 'top_level.txt')
metadata = Metadata(path=path, scheme='legacy')
else:
raise DistlibException('path must end with .egg-info or .egg, '
'got %r' % path)
if requires:
metadata.add_requirements(requires)
# look for top-level modules in top_level.txt, if present
if tl_data is None:
if tl_path is not None and os.path.exists(tl_path):
with open(tl_path, 'rb') as f:
tl_data = f.read().decode('utf-8')
if not tl_data:
tl_data = []
else:
tl_data = tl_data.splitlines()
self.modules = tl_data
return metadata
def __repr__(self):
return '' % (self.name, self.version, self.path)
def __str__(self):
return "%s %s" % (self.name, self.version)
def check_installed_files(self):
"""
Checks that the hashes and sizes of the files in ``RECORD`` are
matched by the files themselves. Returns a (possibly empty) list of
mismatches. Each entry in the mismatch list will be a tuple consisting
of the path, 'exists', 'size' or 'hash' according to what didn't match
(existence is checked first, then size, then hash), the expected
value and the actual value.
"""
mismatches = []
record_path = os.path.join(self.path, 'installed-files.txt')
if os.path.exists(record_path):
for path, _, _ in self.list_installed_files():
if path == record_path:
continue
if not os.path.exists(path):
mismatches.append((path, 'exists', True, False))
return mismatches
def list_installed_files(self):
"""
Iterates over the ``installed-files.txt`` entries and returns a tuple
``(path, hash, size)`` for each line.
:returns: a list of (path, hash, size)
"""
def _md5(path):
f = open(path, 'rb')
try:
content = f.read()
finally:
f.close()
return hashlib.md5(content).hexdigest()
def _size(path):
return os.stat(path).st_size
record_path = os.path.join(self.path, 'installed-files.txt')
result = []
if os.path.exists(record_path):
with codecs.open(record_path, 'r', encoding='utf-8') as f:
for line in f:
line = line.strip()
p = os.path.normpath(os.path.join(self.path, line))
# "./" is present as a marker between installed files
# and installation metadata files
if not os.path.exists(p):
logger.warning('Non-existent file: %s', p)
if p.endswith(('.pyc', '.pyo')):
continue
# otherwise fall through and fail
if not os.path.isdir(p):
result.append((p, _md5(p), _size(p)))
result.append((record_path, None, None))
return result
def list_distinfo_files(self, absolute=False):
"""
Iterates over the ``installed-files.txt`` entries and returns paths for
each line if the path is pointing to a file located in the
``.egg-info`` directory or one of its subdirectories.
:parameter absolute: If *absolute* is ``True``, each returned path is
transformed into a local absolute path. Otherwise the
raw value from ``installed-files.txt`` is returned.
:type absolute: boolean
:returns: iterator of paths
"""
record_path = os.path.join(self.path, 'installed-files.txt')
if os.path.exists(record_path):
skip = True
with codecs.open(record_path, 'r', encoding='utf-8') as f:
for line in f:
line = line.strip()
if line == './':
skip = False
continue
if not skip:
p = os.path.normpath(os.path.join(self.path, line))
if p.startswith(self.path):
if absolute:
yield p
else:
yield line
def __eq__(self, other):
return (isinstance(other, EggInfoDistribution) and self.path == other.path)
# See http://docs.python.org/reference/datamodel#object.__hash__
__hash__ = object.__hash__
new_dist_class = InstalledDistribution
old_dist_class = EggInfoDistribution
class DependencyGraph(object):
"""
Represents a dependency graph between distributions.
The dependency relationships are stored in an ``adjacency_list`` that maps
distributions to a list of ``(other, label)`` tuples where ``other``
is a distribution and the edge is labeled with ``label`` (i.e. the version
specifier, if such was provided). Also, for more efficient traversal, for
every distribution ``x``, a list of predecessors is kept in
``reverse_list[x]``. An edge from distribution ``a`` to
distribution ``b`` means that ``a`` depends on ``b``. If any missing
dependencies are found, they are stored in ``missing``, which is a
dictionary that maps distributions to a list of requirements that were not
provided by any other distributions.
"""
def __init__(self):
self.adjacency_list = {}
self.reverse_list = {}
self.missing = {}
def add_distribution(self, distribution):
"""Add the *distribution* to the graph.
:type distribution: :class:`distutils2.database.InstalledDistribution`
or :class:`distutils2.database.EggInfoDistribution`
"""
self.adjacency_list[distribution] = []
self.reverse_list[distribution] = []
# self.missing[distribution] = []
def add_edge(self, x, y, label=None):
"""Add an edge from distribution *x* to distribution *y* with the given
*label*.
:type x: :class:`distutils2.database.InstalledDistribution` or
:class:`distutils2.database.EggInfoDistribution`
:type y: :class:`distutils2.database.InstalledDistribution` or
:class:`distutils2.database.EggInfoDistribution`
:type label: ``str`` or ``None``
"""
self.adjacency_list[x].append((y, label))
# multiple edges are allowed, so be careful
if x not in self.reverse_list[y]:
self.reverse_list[y].append(x)
def add_missing(self, distribution, requirement):
"""
Add a missing *requirement* for the given *distribution*.
:type distribution: :class:`distutils2.database.InstalledDistribution`
or :class:`distutils2.database.EggInfoDistribution`
:type requirement: ``str``
"""
logger.debug('%s missing %r', distribution, requirement)
self.missing.setdefault(distribution, []).append(requirement)
def _repr_dist(self, dist):
return '%s %s' % (dist.name, dist.version)
def repr_node(self, dist, level=1):
"""Prints only a subgraph"""
output = [self._repr_dist(dist)]
for other, label in self.adjacency_list[dist]:
dist = self._repr_dist(other)
if label is not None:
dist = '%s [%s]' % (dist, label)
output.append(' ' * level + str(dist))
suboutput = self.repr_node(other, level + 1)
subs = suboutput.split('\n')
output.extend(subs[1:])
return '\n'.join(output)
def to_dot(self, f, skip_disconnected=True):
"""Writes a DOT output for the graph to the provided file *f*.
If *skip_disconnected* is set to ``True``, then all distributions
that are not dependent on any other distribution are skipped.
:type f: has to support ``file``-like operations
:type skip_disconnected: ``bool``
"""
disconnected = []
f.write("digraph dependencies {\n")
for dist, adjs in self.adjacency_list.items():
if len(adjs) == 0 and not skip_disconnected:
disconnected.append(dist)
for other, label in adjs:
if label is not None:
f.write('"%s" -> "%s" [label="%s"]\n' % (dist.name, other.name, label))
else:
f.write('"%s" -> "%s"\n' % (dist.name, other.name))
if not skip_disconnected and len(disconnected) > 0:
f.write('subgraph disconnected {\n')
f.write('label = "Disconnected"\n')
f.write('bgcolor = red\n')
for dist in disconnected:
f.write('"%s"' % dist.name)
f.write('\n')
f.write('}\n')
f.write('}\n')
def topological_sort(self):
"""
Perform a topological sort of the graph.
:return: A tuple, the first element of which is a topologically sorted
list of distributions, and the second element of which is a
list of distributions that cannot be sorted because they have
circular dependencies and so form a cycle.
"""
result = []
# Make a shallow copy of the adjacency list
alist = {}
for k, v in self.adjacency_list.items():
alist[k] = v[:]
while True:
# See what we can remove in this run
to_remove = []
for k, v in list(alist.items())[:]:
if not v:
to_remove.append(k)
del alist[k]
if not to_remove:
# What's left in alist (if anything) is a cycle.
break
# Remove from the adjacency list of others
for k, v in alist.items():
alist[k] = [(d, r) for d, r in v if d not in to_remove]
logger.debug('Moving to result: %s', ['%s (%s)' % (d.name, d.version) for d in to_remove])
result.extend(to_remove)
return result, list(alist.keys())
def __repr__(self):
"""Representation of the graph"""
output = []
for dist, adjs in self.adjacency_list.items():
output.append(self.repr_node(dist))
return '\n'.join(output)
def make_graph(dists, scheme='default'):
"""Makes a dependency graph from the given distributions.
:parameter dists: a list of distributions
:type dists: list of :class:`distutils2.database.InstalledDistribution` and
:class:`distutils2.database.EggInfoDistribution` instances
:rtype: a :class:`DependencyGraph` instance
"""
scheme = get_scheme(scheme)
graph = DependencyGraph()
provided = {} # maps names to lists of (version, dist) tuples
# first, build the graph and find out what's provided
for dist in dists:
graph.add_distribution(dist)
for p in dist.provides:
name, version = parse_name_and_version(p)
logger.debug('Add to provided: %s, %s, %s', name, version, dist)
provided.setdefault(name, []).append((version, dist))
# now make the edges
for dist in dists:
requires = (dist.run_requires | dist.meta_requires | dist.build_requires | dist.dev_requires)
for req in requires:
try:
matcher = scheme.matcher(req)
except UnsupportedVersionError:
# XXX compat-mode if cannot read the version
logger.warning('could not read version %r - using name only', req)
name = req.split()[0]
matcher = scheme.matcher(name)
name = matcher.key # case-insensitive
matched = False
if name in provided:
for version, provider in provided[name]:
try:
match = matcher.match(version)
except UnsupportedVersionError:
match = False
if match:
graph.add_edge(dist, provider, req)
matched = True
break
if not matched:
graph.add_missing(dist, req)
return graph
def get_dependent_dists(dists, dist):
"""Recursively generate a list of distributions from *dists* that are
dependent on *dist*.
:param dists: a list of distributions
:param dist: a distribution, member of *dists* for which we are interested
"""
if dist not in dists:
raise DistlibException('given distribution %r is not a member '
'of the list' % dist.name)
graph = make_graph(dists)
dep = [dist] # dependent distributions
todo = graph.reverse_list[dist] # list of nodes we should inspect
while todo:
d = todo.pop()
dep.append(d)
for succ in graph.reverse_list[d]:
if succ not in dep:
todo.append(succ)
dep.pop(0) # remove dist from dep, was there to prevent infinite loops
return dep
def get_required_dists(dists, dist):
"""Recursively generate a list of distributions from *dists* that are
required by *dist*.
:param dists: a list of distributions
:param dist: a distribution, member of *dists* for which we are interested
in finding the dependencies.
"""
if dist not in dists:
raise DistlibException('given distribution %r is not a member '
'of the list' % dist.name)
graph = make_graph(dists)
req = set() # required distributions
todo = graph.adjacency_list[dist] # list of nodes we should inspect
seen = set(t[0] for t in todo) # already added to todo
while todo:
d = todo.pop()[0]
req.add(d)
pred_list = graph.adjacency_list[d]
for pred in pred_list:
d = pred[0]
if d not in req and d not in seen:
seen.add(d)
todo.append(pred)
return req
def make_dist(name, version, **kwargs):
"""
A convenience method for making a dist given just a name and version.
"""
summary = kwargs.pop('summary', 'Placeholder for summary')
md = Metadata(**kwargs)
md.name = name
md.version = version
md.summary = summary or 'Placeholder for summary'
return Distribution(md)
././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1702289035.0
distlib-0.4.3/distlib/index.py 0000644 0001750 0001750 00000050475 14535557213 015406 0 ustar 00vinay vinay # -*- coding: utf-8 -*-
#
# Copyright (C) 2013-2023 Vinay Sajip.
# Licensed to the Python Software Foundation under a contributor agreement.
# See LICENSE.txt and CONTRIBUTORS.txt.
#
import hashlib
import logging
import os
import shutil
import subprocess
import tempfile
try:
from threading import Thread
except ImportError: # pragma: no cover
from dummy_threading import Thread
from . import DistlibException
from .compat import (HTTPBasicAuthHandler, Request, HTTPPasswordMgr,
urlparse, build_opener, string_types)
from .util import zip_dir, ServerProxy
logger = logging.getLogger(__name__)
DEFAULT_INDEX = 'https://pypi.org/pypi'
DEFAULT_REALM = 'pypi'
class PackageIndex(object):
"""
This class represents a package index compatible with PyPI, the Python
Package Index.
"""
boundary = b'----------ThIs_Is_tHe_distlib_index_bouNdaRY_$'
def __init__(self, url=None):
"""
Initialise an instance.
:param url: The URL of the index. If not specified, the URL for PyPI is
used.
"""
self.url = url or DEFAULT_INDEX
self.read_configuration()
scheme, netloc, path, params, query, frag = urlparse(self.url)
if params or query or frag or scheme not in ('http', 'https'):
raise DistlibException('invalid repository: %s' % self.url)
self.password_handler = None
self.ssl_verifier = None
self.gpg = None
self.gpg_home = None
with open(os.devnull, 'w') as sink:
# Use gpg by default rather than gpg2, as gpg2 insists on
# prompting for passwords
for s in ('gpg', 'gpg2'):
try:
rc = subprocess.check_call([s, '--version'], stdout=sink,
stderr=sink)
if rc == 0:
self.gpg = s
break
except OSError:
pass
def _get_pypirc_command(self):
"""
Get the distutils command for interacting with PyPI configurations.
:return: the command.
"""
from .util import _get_pypirc_command as cmd
return cmd()
def read_configuration(self):
"""
Read the PyPI access configuration as supported by distutils. This populates
``username``, ``password``, ``realm`` and ``url`` attributes from the
configuration.
"""
from .util import _load_pypirc
cfg = _load_pypirc(self)
self.username = cfg.get('username')
self.password = cfg.get('password')
self.realm = cfg.get('realm', 'pypi')
self.url = cfg.get('repository', self.url)
def save_configuration(self):
"""
Save the PyPI access configuration. You must have set ``username`` and
``password`` attributes before calling this method.
"""
self.check_credentials()
from .util import _store_pypirc
_store_pypirc(self)
def check_credentials(self):
"""
Check that ``username`` and ``password`` have been set, and raise an
exception if not.
"""
if self.username is None or self.password is None:
raise DistlibException('username and password must be set')
pm = HTTPPasswordMgr()
_, netloc, _, _, _, _ = urlparse(self.url)
pm.add_password(self.realm, netloc, self.username, self.password)
self.password_handler = HTTPBasicAuthHandler(pm)
def register(self, metadata): # pragma: no cover
"""
Register a distribution on PyPI, using the provided metadata.
:param metadata: A :class:`Metadata` instance defining at least a name
and version number for the distribution to be
registered.
:return: The HTTP response received from PyPI upon submission of the
request.
"""
self.check_credentials()
metadata.validate()
d = metadata.todict()
d[':action'] = 'verify'
request = self.encode_request(d.items(), [])
self.send_request(request)
d[':action'] = 'submit'
request = self.encode_request(d.items(), [])
return self.send_request(request)
def _reader(self, name, stream, outbuf):
"""
Thread runner for reading lines of from a subprocess into a buffer.
:param name: The logical name of the stream (used for logging only).
:param stream: The stream to read from. This will typically a pipe
connected to the output stream of a subprocess.
:param outbuf: The list to append the read lines to.
"""
while True:
s = stream.readline()
if not s:
break
s = s.decode('utf-8').rstrip()
outbuf.append(s)
logger.debug('%s: %s' % (name, s))
stream.close()
def get_sign_command(self, filename, signer, sign_password, keystore=None): # pragma: no cover
"""
Return a suitable command for signing a file.
:param filename: The pathname to the file to be signed.
:param signer: The identifier of the signer of the file.
:param sign_password: The passphrase for the signer's
private key used for signing.
:param keystore: The path to a directory which contains the keys
used in verification. If not specified, the
instance's ``gpg_home`` attribute is used instead.
:return: The signing command as a list suitable to be
passed to :class:`subprocess.Popen`.
"""
cmd = [self.gpg, '--status-fd', '2', '--no-tty']
if keystore is None:
keystore = self.gpg_home
if keystore:
cmd.extend(['--homedir', keystore])
if sign_password is not None:
cmd.extend(['--batch', '--passphrase-fd', '0'])
td = tempfile.mkdtemp()
sf = os.path.join(td, os.path.basename(filename) + '.asc')
cmd.extend(['--detach-sign', '--armor', '--local-user',
signer, '--output', sf, filename])
logger.debug('invoking: %s', ' '.join(cmd))
return cmd, sf
def run_command(self, cmd, input_data=None):
"""
Run a command in a child process , passing it any input data specified.
:param cmd: The command to run.
:param input_data: If specified, this must be a byte string containing
data to be sent to the child process.
:return: A tuple consisting of the subprocess' exit code, a list of
lines read from the subprocess' ``stdout``, and a list of
lines read from the subprocess' ``stderr``.
"""
kwargs = {
'stdout': subprocess.PIPE,
'stderr': subprocess.PIPE,
}
if input_data is not None:
kwargs['stdin'] = subprocess.PIPE
stdout = []
stderr = []
p = subprocess.Popen(cmd, **kwargs)
# We don't use communicate() here because we may need to
# get clever with interacting with the command
t1 = Thread(target=self._reader, args=('stdout', p.stdout, stdout))
t1.start()
t2 = Thread(target=self._reader, args=('stderr', p.stderr, stderr))
t2.start()
if input_data is not None:
p.stdin.write(input_data)
p.stdin.close()
p.wait()
t1.join()
t2.join()
return p.returncode, stdout, stderr
def sign_file(self, filename, signer, sign_password, keystore=None): # pragma: no cover
"""
Sign a file.
:param filename: The pathname to the file to be signed.
:param signer: The identifier of the signer of the file.
:param sign_password: The passphrase for the signer's
private key used for signing.
:param keystore: The path to a directory which contains the keys
used in signing. If not specified, the instance's
``gpg_home`` attribute is used instead.
:return: The absolute pathname of the file where the signature is
stored.
"""
cmd, sig_file = self.get_sign_command(filename, signer, sign_password,
keystore)
rc, stdout, stderr = self.run_command(cmd,
sign_password.encode('utf-8'))
if rc != 0:
raise DistlibException('sign command failed with error '
'code %s' % rc)
return sig_file
def upload_file(self, metadata, filename, signer=None, sign_password=None,
filetype='sdist', pyversion='source', keystore=None):
"""
Upload a release file to the index.
:param metadata: A :class:`Metadata` instance defining at least a name
and version number for the file to be uploaded.
:param filename: The pathname of the file to be uploaded.
:param signer: The identifier of the signer of the file.
:param sign_password: The passphrase for the signer's
private key used for signing.
:param filetype: The type of the file being uploaded. This is the
distutils command which produced that file, e.g.
``sdist`` or ``bdist_wheel``.
:param pyversion: The version of Python which the release relates
to. For code compatible with any Python, this would
be ``source``, otherwise it would be e.g. ``3.2``.
:param keystore: The path to a directory which contains the keys
used in signing. If not specified, the instance's
``gpg_home`` attribute is used instead.
:return: The HTTP response received from PyPI upon submission of the
request.
"""
self.check_credentials()
if not os.path.exists(filename):
raise DistlibException('not found: %s' % filename)
metadata.validate()
d = metadata.todict()
sig_file = None
if signer:
if not self.gpg:
logger.warning('no signing program available - not signed')
else:
sig_file = self.sign_file(filename, signer, sign_password,
keystore)
with open(filename, 'rb') as f:
file_data = f.read()
md5_digest = hashlib.md5(file_data).hexdigest()
sha256_digest = hashlib.sha256(file_data).hexdigest()
d.update({
':action': 'file_upload',
'protocol_version': '1',
'filetype': filetype,
'pyversion': pyversion,
'md5_digest': md5_digest,
'sha256_digest': sha256_digest,
})
files = [('content', os.path.basename(filename), file_data)]
if sig_file:
with open(sig_file, 'rb') as f:
sig_data = f.read()
files.append(('gpg_signature', os.path.basename(sig_file),
sig_data))
shutil.rmtree(os.path.dirname(sig_file))
request = self.encode_request(d.items(), files)
return self.send_request(request)
def upload_documentation(self, metadata, doc_dir): # pragma: no cover
"""
Upload documentation to the index.
:param metadata: A :class:`Metadata` instance defining at least a name
and version number for the documentation to be
uploaded.
:param doc_dir: The pathname of the directory which contains the
documentation. This should be the directory that
contains the ``index.html`` for the documentation.
:return: The HTTP response received from PyPI upon submission of the
request.
"""
self.check_credentials()
if not os.path.isdir(doc_dir):
raise DistlibException('not a directory: %r' % doc_dir)
fn = os.path.join(doc_dir, 'index.html')
if not os.path.exists(fn):
raise DistlibException('not found: %r' % fn)
metadata.validate()
name, version = metadata.name, metadata.version
zip_data = zip_dir(doc_dir).getvalue()
fields = [(':action', 'doc_upload'),
('name', name), ('version', version)]
files = [('content', name, zip_data)]
request = self.encode_request(fields, files)
return self.send_request(request)
def get_verify_command(self, signature_filename, data_filename,
keystore=None):
"""
Return a suitable command for verifying a file.
:param signature_filename: The pathname to the file containing the
signature.
:param data_filename: The pathname to the file containing the
signed data.
:param keystore: The path to a directory which contains the keys
used in verification. If not specified, the
instance's ``gpg_home`` attribute is used instead.
:return: The verifying command as a list suitable to be
passed to :class:`subprocess.Popen`.
"""
cmd = [self.gpg, '--status-fd', '2', '--no-tty']
if keystore is None:
keystore = self.gpg_home
if keystore:
cmd.extend(['--homedir', keystore])
cmd.extend(['--verify', signature_filename, data_filename])
logger.debug('invoking: %s', ' '.join(cmd))
return cmd
def verify_signature(self, signature_filename, data_filename,
keystore=None):
"""
Verify a signature for a file.
:param signature_filename: The pathname to the file containing the
signature.
:param data_filename: The pathname to the file containing the
signed data.
:param keystore: The path to a directory which contains the keys
used in verification. If not specified, the
instance's ``gpg_home`` attribute is used instead.
:return: True if the signature was verified, else False.
"""
if not self.gpg:
raise DistlibException('verification unavailable because gpg '
'unavailable')
cmd = self.get_verify_command(signature_filename, data_filename,
keystore)
rc, stdout, stderr = self.run_command(cmd)
if rc not in (0, 1):
raise DistlibException('verify command failed with error code %s' % rc)
return rc == 0
def download_file(self, url, destfile, digest=None, reporthook=None):
"""
This is a convenience method for downloading a file from an URL.
Normally, this will be a file from the index, though currently
no check is made for this (i.e. a file can be downloaded from
anywhere).
The method is just like the :func:`urlretrieve` function in the
standard library, except that it allows digest computation to be
done during download and checking that the downloaded data
matched any expected value.
:param url: The URL of the file to be downloaded (assumed to be
available via an HTTP GET request).
:param destfile: The pathname where the downloaded file is to be
saved.
:param digest: If specified, this must be a (hasher, value)
tuple, where hasher is the algorithm used (e.g.
``'md5'``) and ``value`` is the expected value.
:param reporthook: The same as for :func:`urlretrieve` in the
standard library.
"""
if digest is None:
digester = None
logger.debug('No digest specified')
else:
if isinstance(digest, (list, tuple)):
hasher, digest = digest
else:
hasher = 'md5'
digester = getattr(hashlib, hasher)()
logger.debug('Digest specified: %s' % digest)
# The following code is equivalent to urlretrieve.
# We need to do it this way so that we can compute the
# digest of the file as we go.
with open(destfile, 'wb') as dfp:
# addinfourl is not a context manager on 2.x
# so we have to use try/finally
sfp = self.send_request(Request(url))
try:
headers = sfp.info()
blocksize = 8192
size = -1
read = 0
blocknum = 0
if "content-length" in headers:
size = int(headers["Content-Length"])
if reporthook:
reporthook(blocknum, blocksize, size)
while True:
block = sfp.read(blocksize)
if not block:
break
read += len(block)
dfp.write(block)
if digester:
digester.update(block)
blocknum += 1
if reporthook:
reporthook(blocknum, blocksize, size)
finally:
sfp.close()
# check that we got the whole file, if we can
if size >= 0 and read < size:
raise DistlibException(
'retrieval incomplete: got only %d out of %d bytes'
% (read, size))
# if we have a digest, it must match.
if digester:
actual = digester.hexdigest()
if digest != actual:
raise DistlibException('%s digest mismatch for %s: expected '
'%s, got %s' % (hasher, destfile,
digest, actual))
logger.debug('Digest verified: %s', digest)
def send_request(self, req):
"""
Send a standard library :class:`Request` to PyPI and return its
response.
:param req: The request to send.
:return: The HTTP response from PyPI (a standard library HTTPResponse).
"""
handlers = []
if self.password_handler:
handlers.append(self.password_handler)
if self.ssl_verifier:
handlers.append(self.ssl_verifier)
opener = build_opener(*handlers)
return opener.open(req)
def encode_request(self, fields, files):
"""
Encode fields and files for posting to an HTTP server.
:param fields: The fields to send as a list of (fieldname, value)
tuples.
:param files: The files to send as a list of (fieldname, filename,
file_bytes) tuple.
"""
# Adapted from packaging, which in turn was adapted from
# http://code.activestate.com/recipes/146306
parts = []
boundary = self.boundary
for k, values in fields:
if not isinstance(values, (list, tuple)):
values = [values]
for v in values:
parts.extend((
b'--' + boundary,
('Content-Disposition: form-data; name="%s"' %
k).encode('utf-8'),
b'',
v.encode('utf-8')))
for key, filename, value in files:
parts.extend((
b'--' + boundary,
('Content-Disposition: form-data; name="%s"; filename="%s"' %
(key, filename)).encode('utf-8'),
b'',
value))
parts.extend((b'--' + boundary + b'--', b''))
body = b'\r\n'.join(parts)
ct = b'multipart/form-data; boundary=' + boundary
headers = {
'Content-type': ct,
'Content-length': str(len(body))
}
return Request(self.url, body, headers)
def search(self, terms, operator=None): # pragma: no cover
if isinstance(terms, string_types):
terms = {'name': terms}
rpc_proxy = ServerProxy(self.url, timeout=3.0)
try:
return rpc_proxy.search(terms, operator or 'and')
finally:
rpc_proxy('close')()
././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1780588013.0
distlib-0.4.3/distlib/locators.py 0000664 0001750 0001750 00000146551 15210316755 016123 0 ustar 00vinay vinay # -*- coding: utf-8 -*-
#
# Copyright (C) 2012-2026 Vinay Sajip.
# Licensed to the Python Software Foundation under a contributor agreement.
# See LICENSE.txt and CONTRIBUTORS.txt.
#
import gzip
from io import BytesIO
import json
import logging
import os
import posixpath
import re
try:
import threading
except ImportError: # pragma: no cover
import dummy_threading as threading
import zlib
from . import DistlibException
from .compat import (urljoin, urlparse, urlunparse, url2pathname, pathname2url, queue, quote, unescape, build_opener,
HTTPRedirectHandler as BaseRedirectHandler, text_type, Request, HTTPError, URLError)
from .database import Distribution, DistributionPath, make_dist
from .metadata import Metadata, MetadataInvalidError
from .util import (cached_property, ensure_slash, split_filename, get_project_data, parse_requirement,
parse_name_and_version, ServerProxy, normalize_name)
from .version import get_scheme, UnsupportedVersionError
from .wheel import Wheel, is_compatible
logger = logging.getLogger(__name__)
HASHER_HASH = re.compile(r'^(\w+)=([a-f0-9]+)')
CHARSET = re.compile(r';\s*charset\s*=\s*(.*)\s*$', re.I)
HTML_CONTENT_TYPE = re.compile('text/html|application/x(ht)?ml')
DEFAULT_INDEX = 'https://pypi.org/pypi'
def get_all_distribution_names(url=None):
"""
Return all distribution names known by an index.
:param url: The URL of the index.
:return: A list of all known distribution names.
"""
if url is None:
url = DEFAULT_INDEX
client = ServerProxy(url, timeout=3.0)
try:
return client.list_packages()
finally:
client('close')()
class RedirectHandler(BaseRedirectHandler):
"""
A class to work around a bug in some Python 3.2.x releases.
"""
# There's a bug in the base version for some 3.2.x
# (e.g. 3.2.2 on Ubuntu Oneiric). If a Location header
# returns e.g. /abc, it bails because it says the scheme ''
# is bogus, when actually it should use the request's
# URL for the scheme. See Python issue #13696.
def http_error_302(self, req, fp, code, msg, headers):
# Some servers (incorrectly) return multiple Location headers
# (so probably same goes for URI). Use first header.
newurl = None
for key in ('location', 'uri'):
if key in headers:
newurl = headers[key]
break
if newurl is None: # pragma: no cover
return
urlparts = urlparse(newurl)
if urlparts.scheme == '':
newurl = urljoin(req.get_full_url(), newurl)
if hasattr(headers, 'replace_header'):
headers.replace_header(key, newurl)
else:
headers[key] = newurl
return BaseRedirectHandler.http_error_302(self, req, fp, code, msg, headers)
http_error_301 = http_error_303 = http_error_307 = http_error_302
class Locator(object):
"""
A base class for locators - things that locate distributions.
"""
source_extensions = ('.tar.gz', '.tar.bz2', '.tar', '.zip', '.tgz', '.tbz')
binary_extensions = ('.egg', '.exe', '.whl')
excluded_extensions = ('.pdf', )
# A list of tags indicating which wheels you want to match. The default
# value of None matches against the tags compatible with the running
# Python. If you want to match other values, set wheel_tags on a locator
# instance to a list of tuples (pyver, abi, arch) which you want to match.
wheel_tags = None
downloadable_extensions = source_extensions + ('.whl', )
def __init__(self, scheme='default'):
"""
Initialise an instance.
:param scheme: Because locators look for most recent versions, they
need to know the version scheme to use. This specifies
the current PEP-recommended scheme - use ``'legacy'``
if you need to support existing distributions on PyPI.
"""
self._cache = {}
self.scheme = scheme
# Because of bugs in some of the handlers on some of the platforms,
# we use our own opener rather than just using urlopen.
self.opener = build_opener(RedirectHandler())
# If get_project() is called from locate(), the matcher instance
# is set from the requirement passed to locate(). See issue #18 for
# why this can be useful to know.
self.matcher = None
self.errors = queue.Queue()
def get_errors(self):
"""
Return any errors which have occurred.
"""
result = []
while not self.errors.empty(): # pragma: no cover
try:
e = self.errors.get(False)
result.append(e)
except self.errors.Empty:
continue
self.errors.task_done()
return result
def clear_errors(self):
"""
Clear any errors which may have been logged.
"""
# Just get the errors and throw them away
self.get_errors()
def clear_cache(self):
self._cache.clear()
def _get_scheme(self):
return self._scheme
def _set_scheme(self, value):
self._scheme = value
scheme = property(_get_scheme, _set_scheme)
def _get_project(self, name):
"""
For a given project, get a dictionary mapping available versions to Distribution
instances.
This should be implemented in subclasses.
If called from a locate() request, self.matcher will be set to a
matcher for the requirement to satisfy, otherwise it will be None.
"""
raise NotImplementedError('Please implement in the subclass')
def get_distribution_names(self):
"""
Return all the distribution names known to this locator.
"""
raise NotImplementedError('Please implement in the subclass')
def get_project(self, name):
"""
For a given project, get a dictionary mapping available versions to Distribution
instances.
This calls _get_project to do all the work, and just implements a caching layer on top.
"""
if self._cache is None: # pragma: no cover
result = self._get_project(name)
elif name in self._cache:
result = self._cache[name]
else:
self.clear_errors()
result = self._get_project(name)
self._cache[name] = result
return result
def score_url(self, url):
"""
Give an url a score which can be used to choose preferred URLs
for a given project release.
"""
t = urlparse(url)
basename = posixpath.basename(t.path)
compatible = True
is_wheel = basename.endswith('.whl')
is_downloadable = basename.endswith(self.downloadable_extensions)
if is_wheel:
compatible = is_compatible(Wheel(basename), self.wheel_tags)
return (t.scheme == 'https', 'pypi.org' in t.netloc, is_downloadable, is_wheel, compatible, basename)
def prefer_url(self, url1, url2):
"""
Choose one of two URLs where both are candidates for distribution
archives for the same version of a distribution (for example,
.tar.gz vs. zip).
The current implementation favours https:// URLs over http://, archives
from PyPI over those from other locations, wheel compatibility (if a
wheel) and then the archive name.
"""
result = url2
if url1:
s1 = self.score_url(url1)
s2 = self.score_url(url2)
if s1 > s2:
result = url1
if result != url2:
logger.debug('Not replacing %r with %r', url1, url2)
else:
logger.debug('Replacing %r with %r', url1, url2)
return result
def split_filename(self, filename, project_name):
"""
Attempt to split a filename in project name, version and Python version.
"""
return split_filename(filename, project_name)
def convert_url_to_download_info(self, url, project_name):
"""
See if a URL is a candidate for a download URL for a project (the URL
has typically been scraped from an HTML page).
If it is, a dictionary is returned with keys "name", "version",
"filename" and "url"; otherwise, None is returned.
"""
def same_project(name1, name2):
return normalize_name(name1) == normalize_name(name2)
result = None
scheme, netloc, path, params, query, frag = urlparse(url)
if frag.lower().startswith('egg='): # pragma: no cover
logger.debug('%s: version hint in fragment: %r', project_name, frag)
m = HASHER_HASH.match(frag)
if m:
algo, digest = m.groups()
else:
algo, digest = None, None
origpath = path
if path and path[-1] == '/': # pragma: no cover
path = path[:-1]
if path.endswith('.whl'):
try:
wheel = Wheel(path)
if not is_compatible(wheel, self.wheel_tags):
logger.debug('Wheel not compatible: %s', path)
else:
if project_name is None:
include = True
else:
include = same_project(wheel.name, project_name)
if include:
result = {
'name': wheel.name,
'version': wheel.version,
'filename': wheel.filename,
'url': urlunparse((scheme, netloc, origpath, params, query, '')),
'python-version': ', '.join(['.'.join(list(v[2:])) for v in wheel.pyver]),
}
except Exception: # pragma: no cover
logger.warning('invalid path for wheel: %s', path)
elif not path.endswith(self.downloadable_extensions): # pragma: no cover
logger.debug('Not downloadable: %s', path)
else: # downloadable extension
path = filename = posixpath.basename(path)
for ext in self.downloadable_extensions:
if path.endswith(ext):
path = path[:-len(ext)]
t = self.split_filename(path, project_name)
if not t: # pragma: no cover
logger.debug('No match for project/version: %s', path)
else:
name, version, pyver = t
if not project_name or same_project(project_name, name):
result = {
'name': name,
'version': version,
'filename': filename,
'url': urlunparse((scheme, netloc, origpath, params, query, '')),
}
if pyver: # pragma: no cover
result['python-version'] = pyver
break
if result and algo:
result['%s_digest' % algo] = digest
return result
def _get_digest(self, info):
"""
Get a digest from a dictionary by looking at a "digests" dictionary
or keys of the form 'algo_digest'.
Returns a 2-tuple (algo, digest) if found, else None. Currently
looks only for SHA256, then MD5.
"""
result = None
if 'digests' in info:
digests = info['digests']
for algo in ('sha256', 'md5'):
if algo in digests:
result = (algo, digests[algo])
break
if not result:
for algo in ('sha256', 'md5'):
key = '%s_digest' % algo
if key in info:
result = (algo, info[key])
break
return result
def _update_version_data(self, result, info):
"""
Update a result dictionary (the final result from _get_project) with a
dictionary for a specific version, which typically holds information
gleaned from a filename or URL for an archive for the distribution.
"""
name = info.pop('name')
version = info.pop('version')
if version in result:
dist = result[version]
md = dist.metadata
else:
dist = make_dist(name, version, scheme=self.scheme)
md = dist.metadata
dist.digest = digest = self._get_digest(info)
url = info['url']
result['digests'][url] = digest
if md.source_url != info['url']:
md.source_url = self.prefer_url(md.source_url, url)
result['urls'].setdefault(version, set()).add(url)
dist.locator = self
result[version] = dist
def locate(self, requirement, prereleases=False):
"""
Find the most recent distribution which matches the given
requirement.
:param requirement: A requirement of the form 'foo (1.0)' or perhaps
'foo (>= 1.0, < 2.0, != 1.3)'
:param prereleases: If ``True``, allow pre-release versions
to be located. Otherwise, pre-release versions
are not returned.
:return: A :class:`Distribution` instance, or ``None`` if no such
distribution could be located.
"""
result = None
r = parse_requirement(requirement)
if r is None: # pragma: no cover
raise DistlibException('Not a valid requirement: %r' % requirement)
scheme = get_scheme(self.scheme)
self.matcher = matcher = scheme.matcher(r.requirement)
logger.debug('matcher: %s (%s)', matcher, type(matcher).__name__)
versions = self.get_project(r.name)
if len(versions) > 2: # urls and digests keys are present
# sometimes, versions are invalid
slist = []
vcls = matcher.version_class
for k in versions:
if k in ('urls', 'digests'):
continue
try:
if not matcher.match(k):
pass # logger.debug('%s did not match %r', matcher, k)
else:
if prereleases or not vcls(k).is_prerelease:
slist.append(k)
except Exception: # pragma: no cover
logger.warning('error matching %s with %r', matcher, k)
pass # slist.append(k)
if len(slist) > 1:
slist = sorted(slist, key=scheme.key)
if slist:
logger.debug('sorted list: %s', slist)
version = slist[-1]
result = versions[version]
if result:
if r.extras:
result.extras = r.extras
result.download_urls = versions.get('urls', {}).get(version, set())
d = {}
sd = versions.get('digests', {})
for url in result.download_urls:
if url in sd: # pragma: no cover
d[url] = sd[url]
result.digests = d
self.matcher = None
return result
class PyPIRPCLocator(Locator):
"""
This locator uses XML-RPC to locate distributions. It therefore
cannot be used with simple mirrors (that only mirror file content).
"""
def __init__(self, url, **kwargs):
"""
Initialise an instance.
:param url: The URL to use for XML-RPC.
:param kwargs: Passed to the superclass constructor.
"""
super(PyPIRPCLocator, self).__init__(**kwargs)
self.base_url = url
self.client = ServerProxy(url, timeout=3.0)
def get_distribution_names(self):
"""
Return all the distribution names known to this locator.
"""
return set(self.client.list_packages())
def _get_project(self, name):
result = {'urls': {}, 'digests': {}}
versions = self.client.package_releases(name, True)
for v in versions:
urls = self.client.release_urls(name, v)
data = self.client.release_data(name, v)
metadata = Metadata(scheme=self.scheme)
metadata.name = data['name']
metadata.version = data['version']
metadata.license = data.get('license')
metadata.keywords = data.get('keywords', [])
metadata.summary = data.get('summary')
dist = Distribution(metadata)
if urls:
info = urls[0]
metadata.source_url = info['url']
dist.digest = self._get_digest(info)
dist.locator = self
result[v] = dist
for info in urls:
url = info['url']
digest = self._get_digest(info)
result['urls'].setdefault(v, set()).add(url)
result['digests'][url] = digest
return result
class PyPIJSONLocator(Locator):
"""
This locator uses PyPI's JSON interface. It's very limited in functionality
and probably not worth using.
"""
def __init__(self, url, **kwargs):
super(PyPIJSONLocator, self).__init__(**kwargs)
self.base_url = ensure_slash(url)
def get_distribution_names(self):
"""
Return all the distribution names known to this locator.
"""
raise NotImplementedError('Not available from this locator')
def _get_project(self, name):
result = {'urls': {}, 'digests': {}}
url = urljoin(self.base_url, '%s/json' % quote(name))
try:
resp = self.opener.open(url)
data = resp.read().decode() # for now
d = json.loads(data)
md = Metadata(scheme=self.scheme)
data = d['info']
md.name = data['name']
md.version = data['version']
md.license = data.get('license')
md.keywords = data.get('keywords', [])
md.summary = data.get('summary')
dist = Distribution(md)
dist.locator = self
# urls = d['urls']
result[md.version] = dist
for info in d['urls']:
url = info['url']
dist.download_urls.add(url)
dist.digests[url] = self._get_digest(info)
result['urls'].setdefault(md.version, set()).add(url)
result['digests'][url] = self._get_digest(info)
# Now get other releases
for version, infos in d['releases'].items():
if version == md.version:
continue # already done
omd = Metadata(scheme=self.scheme)
omd.name = md.name
omd.version = version
odist = Distribution(omd)
odist.locator = self
result[version] = odist
for info in infos:
url = info['url']
odist.download_urls.add(url)
odist.digests[url] = self._get_digest(info)
result['urls'].setdefault(version, set()).add(url)
result['digests'][url] = self._get_digest(info)
# for info in urls:
# md.source_url = info['url']
# dist.digest = self._get_digest(info)
# dist.locator = self
# for info in urls:
# url = info['url']
# result['urls'].setdefault(md.version, set()).add(url)
# result['digests'][url] = self._get_digest(info)
except Exception as e:
self.errors.put(text_type(e))
logger.exception('JSON fetch failed: %s', e)
return result
class Page(object):
"""
This class represents a scraped HTML page.
"""
# The following slightly hairy-looking regex just looks for the contents of
# an anchor link, which has an attribute "href" either immediately preceded
# or immediately followed by a "rel" attribute. The attribute values can be
# declared with double quotes, single quotes or no quotes - which leads to
# the length of the expression.
_href = re.compile(
"""
(rel\\s*=\\s*(?:"(?P[^"]*)"|'(?P[^']*)'|(?P[^>\\s\n]*))\\s+)?
href\\s*=\\s*(?:"(?P[^"]*)"|'(?P[^']*)'|(?P[^>\\s\n]*))
(\\s+rel\\s*=\\s*(?:"(?P[^"]*)"|'(?P[^']*)'|(?P[^>\\s\n]*)))?
""", re.I | re.S | re.X)
_base = re.compile(r"""]+)""", re.I | re.S)
def __init__(self, data, url):
"""
Initialise an instance with the Unicode page contents and the URL they
came from.
"""
self.data = data
self.base_url = self.url = url
m = self._base.search(self.data)
if m:
self.base_url = m.group(1)
_clean_re = re.compile(r'[^a-z0-9$&+,/:;=?@.#%_\\|-]', re.I)
@cached_property
def links(self):
"""
Return the URLs of all the links on a page together with information
about their "rel" attribute, for determining which ones to treat as
downloads and which ones to queue for further scraping.
"""
def clean(url):
"Tidy up an URL."
scheme, netloc, path, params, query, frag = urlparse(url)
return urlunparse((scheme, netloc, quote(path), params, query, frag))
result = set()
for match in self._href.finditer(self.data):
d = match.groupdict('')
rel = (d['rel1'] or d['rel2'] or d['rel3'] or d['rel4'] or d['rel5'] or d['rel6'])
url = d['url1'] or d['url2'] or d['url3']
url = urljoin(self.base_url, url)
url = unescape(url)
url = self._clean_re.sub(lambda m: '%%%02x' % ord(m.group(0)), url)
result.add((url, rel))
# We sort the result, hoping to bring the most recent versions
# to the front
result = sorted(result, key=lambda t: t[0], reverse=True)
return result
class SimpleScrapingLocator(Locator):
"""
A locator which scrapes HTML pages to locate downloads for a distribution.
This runs multiple threads to do the I/O; performance is at least as good
as pip's PackageFinder, which works in an analogous fashion.
"""
# Upper bound, in bytes, on the size a Content-Encoded index response
# may inflate to. A compressed response can expand by a very large ratio
# (a few hundred KB inflating to hundreds of MB), so decompression is
# capped to avoid unbounded memory use from a malicious or compromised
# index. Index pages are HTML listings, so this limit is generous.
decode_size_limit = 100 * 1024 * 1024
def _decompress(self, data, decompressor):
# Decompress and abort if the inflated output would exceed
# decode_size_limit. zlib's decompress(max_length) bounds the output
# of a single call; ask for one byte past the limit to detect
# overflow, then ensure nothing remains unconsumed.
limit = self.decode_size_limit
produced = decompressor.decompress(data, limit + 1)
if len(produced) > limit or decompressor.unconsumed_tail:
raise DistlibException('Decompressed index response exceeds '
'%d bytes' % limit)
produced += decompressor.flush()
if len(produced) > limit:
raise DistlibException('Decompressed index response exceeds '
'%d bytes' % limit)
return produced
def __init__(self, url, timeout=None, num_workers=10, **kwargs):
"""
Initialise an instance.
:param url: The root URL to use for scraping.
:param timeout: The timeout, in seconds, to be applied to requests.
This defaults to ``None`` (no timeout specified).
:param num_workers: The number of worker threads you want to do I/O,
This defaults to 10.
:param kwargs: Passed to the superclass.
"""
super(SimpleScrapingLocator, self).__init__(**kwargs)
self.base_url = ensure_slash(url)
self.timeout = timeout
self._page_cache = {}
self._seen = set()
self._to_fetch = queue.Queue()
self._bad_hosts = set()
self.skip_externals = False
self.num_workers = num_workers
self._lock = threading.RLock()
# See issue #45: we need to be resilient when the locator is used
# in a thread, e.g. with concurrent.futures. We can't use self._lock
# as it is for coordinating our internal threads - the ones created
# in _prepare_threads.
self._gplock = threading.RLock()
self.platform_check = False # See issue #112
# These are used to deal with various Content-Encoding schemes. Each
# decoder bounds its inflated output to decode_size_limit (see
# _decompress) to avoid unbounded memory use from a hostile index.
self.decoders = {
'deflate': lambda b: self._decompress(b, zlib.decompressobj()),
# wbits 16 + MAX_WBITS selects gzip framing in zlib.
'gzip': lambda b: self._decompress(b, zlib.decompressobj(16 + zlib.MAX_WBITS)),
'none': lambda b: b,
}
def _prepare_threads(self):
"""
Threads are created only when get_project is called, and terminate
before it returns. They are there primarily to parallelise I/O (i.e.
fetching web pages).
"""
self._threads = []
for i in range(self.num_workers):
t = threading.Thread(target=self._fetch)
t.daemon = True
t.start()
self._threads.append(t)
def _wait_threads(self):
"""
Tell all the threads to terminate (by sending a sentinel value) and
wait for them to do so.
"""
# Note that you need two loops, since you can't say which
# thread will get each sentinel
for t in self._threads:
self._to_fetch.put(None) # sentinel
for t in self._threads:
t.join()
self._threads = []
def _get_project(self, name):
result = {'urls': {}, 'digests': {}}
with self._gplock:
self.result = result
self.project_name = name
url = urljoin(self.base_url, '%s/' % quote(name))
self._seen.clear()
self._page_cache.clear()
self._prepare_threads()
try:
logger.debug('Queueing %s', url)
self._to_fetch.put(url)
self._to_fetch.join()
finally:
self._wait_threads()
del self.result
return result
platform_dependent = re.compile(r'\b(linux_(i\d86|x86_64|arm\w+)|'
r'win(32|_amd64)|macosx_?\d+)\b', re.I)
def _is_platform_dependent(self, url):
"""
Does an URL refer to a platform-specific download?
"""
return self.platform_dependent.search(url)
def _process_download(self, url):
"""
See if an URL is a suitable download for a project.
If it is, register information in the result dictionary (for
_get_project) about the specific version it's for.
Note that the return value isn't actually used other than as a boolean
value.
"""
if self.platform_check and self._is_platform_dependent(url):
info = None
else:
info = self.convert_url_to_download_info(url, self.project_name)
logger.debug('process_download: %s -> %s', url, info)
if info:
with self._lock: # needed because self.result is shared
self._update_version_data(self.result, info)
return info
def _should_queue(self, link, referrer, rel):
"""
Determine whether a link URL from a referring page and with a
particular "rel" attribute should be queued for scraping.
"""
scheme, netloc, path, _, _, _ = urlparse(link)
if path.endswith(self.source_extensions + self.binary_extensions + self.excluded_extensions):
result = False
elif self.skip_externals and not link.startswith(self.base_url):
result = False
elif not referrer.startswith(self.base_url):
result = False
elif rel not in ('homepage', 'download'):
result = False
elif scheme not in ('http', 'https', 'ftp'):
result = False
elif self._is_platform_dependent(link):
result = False
else:
host = netloc.split(':', 1)[0]
if host.lower() == 'localhost':
result = False
else:
result = True
logger.debug('should_queue: %s (%s) from %s -> %s', link, rel, referrer, result)
return result
def _fetch(self):
"""
Get a URL to fetch from the work queue, get the HTML page, examine its
links for download candidates and candidates for further scraping.
This is a handy method to run in a thread.
"""
while True:
url = self._to_fetch.get()
try:
if url:
page = self.get_page(url)
if page is None: # e.g. after an error
continue
for link, rel in page.links:
if link not in self._seen:
try:
self._seen.add(link)
if (not self._process_download(link) and self._should_queue(link, url, rel)):
logger.debug('Queueing %s from %s', link, url)
self._to_fetch.put(link)
except MetadataInvalidError: # e.g. invalid versions
pass
except Exception as e: # pragma: no cover
self.errors.put(text_type(e))
finally:
# always do this, to avoid hangs :-)
self._to_fetch.task_done()
if not url:
# logger.debug('Sentinel seen, quitting.')
break
def get_page(self, url):
"""
Get the HTML for an URL, possibly from an in-memory cache.
XXX TODO Note: this cache is never actually cleared. It's assumed that
the data won't get stale over the lifetime of a locator instance (not
necessarily true for the default_locator).
"""
# http://peak.telecommunity.com/DevCenter/EasyInstall#package-index-api
scheme, netloc, path, _, _, _ = urlparse(url)
if scheme == 'file' and os.path.isdir(url2pathname(path)):
url = urljoin(ensure_slash(url), 'index.html')
if url in self._page_cache:
result = self._page_cache[url]
logger.debug('Returning %s from cache: %s', url, result)
else:
host = netloc.split(':', 1)[0]
result = None
if host in self._bad_hosts:
logger.debug('Skipping %s due to bad host %s', url, host)
else:
req = Request(url, headers={'Accept-encoding': 'identity'})
try:
logger.debug('Fetching %s', url)
resp = self.opener.open(req, timeout=self.timeout)
logger.debug('Fetched %s', url)
headers = resp.info()
content_type = headers.get('Content-Type', '')
if HTML_CONTENT_TYPE.match(content_type):
final_url = resp.geturl()
data = resp.read()
encoding = headers.get('Content-Encoding')
if encoding:
decoder = self.decoders[encoding] # fail if not found
data = decoder(data)
encoding = 'utf-8'
m = CHARSET.search(content_type)
if m:
encoding = m.group(1)
try:
data = data.decode(encoding)
except UnicodeError: # pragma: no cover
data = data.decode('latin-1') # fallback
result = Page(data, final_url)
self._page_cache[final_url] = result
except HTTPError as e:
if e.code != 404:
logger.exception('Fetch failed: %s: %s', url, e)
except URLError as e: # pragma: no cover
logger.exception('Fetch failed: %s: %s', url, e)
with self._lock:
self._bad_hosts.add(host)
except Exception as e: # pragma: no cover
logger.exception('Fetch failed: %s: %s', url, e)
finally:
self._page_cache[url] = result # even if None (failure)
return result
_distname_re = re.compile(']*>([^<]+)<')
def get_distribution_names(self):
"""
Return all the distribution names known to this locator.
"""
result = set()
page = self.get_page(self.base_url)
if not page:
raise DistlibException('Unable to get %s' % self.base_url)
for match in self._distname_re.finditer(page.data):
result.add(match.group(1))
return result
class DirectoryLocator(Locator):
"""
This class locates distributions in a directory tree.
"""
def __init__(self, path, **kwargs):
"""
Initialise an instance.
:param path: The root of the directory tree to search.
:param kwargs: Passed to the superclass constructor,
except for:
* recursive - if True (the default), subdirectories are
recursed into. If False, only the top-level directory
is searched,
"""
self.recursive = kwargs.pop('recursive', True)
super(DirectoryLocator, self).__init__(**kwargs)
path = os.path.abspath(path)
if not os.path.isdir(path): # pragma: no cover
raise DistlibException('Not a directory: %r' % path)
self.base_dir = path
def should_include(self, filename, parent):
"""
Should a filename be considered as a candidate for a distribution
archive? As well as the filename, the directory which contains it
is provided, though not used by the current implementation.
"""
return filename.endswith(self.downloadable_extensions)
def _get_project(self, name):
result = {'urls': {}, 'digests': {}}
for root, dirs, files in os.walk(self.base_dir):
for fn in files:
if self.should_include(fn, root):
fn = os.path.join(root, fn)
url = urlunparse(('file', '', pathname2url(os.path.abspath(fn)), '', '', ''))
info = self.convert_url_to_download_info(url, name)
if info:
self._update_version_data(result, info)
if not self.recursive:
break
return result
def get_distribution_names(self):
"""
Return all the distribution names known to this locator.
"""
result = set()
for root, dirs, files in os.walk(self.base_dir):
for fn in files:
if self.should_include(fn, root):
fn = os.path.join(root, fn)
url = urlunparse(('file', '', pathname2url(os.path.abspath(fn)), '', '', ''))
info = self.convert_url_to_download_info(url, None)
if info:
result.add(info['name'])
if not self.recursive:
break
return result
class JSONLocator(Locator):
"""
This locator uses special extended metadata (not available on PyPI) and is
the basis of performant dependency resolution in distlib. Other locators
require archive downloads before dependencies can be determined! As you
might imagine, that can be slow.
"""
def get_distribution_names(self):
"""
Return all the distribution names known to this locator.
"""
raise NotImplementedError('Not available from this locator')
def _get_project(self, name):
result = {'urls': {}, 'digests': {}}
data = get_project_data(name)
if data:
for info in data.get('files', []):
if info['ptype'] != 'sdist' or info['pyversion'] != 'source':
continue
# We don't store summary in project metadata as it makes
# the data bigger for no benefit during dependency
# resolution
dist = make_dist(data['name'],
info['version'],
summary=data.get('summary', 'Placeholder for summary'),
scheme=self.scheme)
md = dist.metadata
md.source_url = info['url']
# TODO SHA256 digest
if 'digest' in info and info['digest']:
dist.digest = ('md5', info['digest'])
md.dependencies = info.get('requirements', {})
dist.exports = info.get('exports', {})
result[dist.version] = dist
result['urls'].setdefault(dist.version, set()).add(info['url'])
return result
class DistPathLocator(Locator):
"""
This locator finds installed distributions in a path. It can be useful for
adding to an :class:`AggregatingLocator`.
"""
def __init__(self, distpath, **kwargs):
"""
Initialise an instance.
:param distpath: A :class:`DistributionPath` instance to search.
"""
super(DistPathLocator, self).__init__(**kwargs)
assert isinstance(distpath, DistributionPath)
self.distpath = distpath
def _get_project(self, name):
dist = self.distpath.get_distribution(name)
if dist is None:
result = {'urls': {}, 'digests': {}}
else:
result = {
dist.version: dist,
'urls': {
dist.version: set([dist.source_url])
},
'digests': {
dist.version: set([None])
}
}
return result
class AggregatingLocator(Locator):
"""
This class allows you to chain and/or merge a list of locators.
"""
def __init__(self, *locators, **kwargs):
"""
Initialise an instance.
:param locators: The list of locators to search.
:param kwargs: Passed to the superclass constructor,
except for:
* merge - if False (the default), the first successful
search from any of the locators is returned. If True,
the results from all locators are merged (this can be
slow).
"""
self.merge = kwargs.pop('merge', False)
self.locators = locators
super(AggregatingLocator, self).__init__(**kwargs)
def clear_cache(self):
super(AggregatingLocator, self).clear_cache()
for locator in self.locators:
locator.clear_cache()
def _set_scheme(self, value):
self._scheme = value
for locator in self.locators:
locator.scheme = value
scheme = property(Locator.scheme.fget, _set_scheme)
def _get_project(self, name):
result = {}
for locator in self.locators:
d = locator.get_project(name)
if d:
if self.merge:
files = result.get('urls', {})
digests = result.get('digests', {})
# next line could overwrite result['urls'], result['digests']
result.update(d)
df = result.get('urls')
if files and df:
for k, v in files.items():
if k in df:
df[k] |= v
else:
df[k] = v
dd = result.get('digests')
if digests and dd:
dd.update(digests)
else:
# See issue #18. If any dists are found and we're looking
# for specific constraints, we only return something if
# a match is found. For example, if a DirectoryLocator
# returns just foo (1.0) while we're looking for
# foo (>= 2.0), we'll pretend there was nothing there so
# that subsequent locators can be queried. Otherwise we
# would just return foo (1.0) which would then lead to a
# failure to find foo (>= 2.0), because other locators
# weren't searched. Note that this only matters when
# merge=False.
if self.matcher is None:
found = True
else:
found = False
for k in d:
if self.matcher.match(k):
found = True
break
if found:
result = d
break
return result
def get_distribution_names(self):
"""
Return all the distribution names known to this locator.
"""
result = set()
for locator in self.locators:
try:
result |= locator.get_distribution_names()
except NotImplementedError:
pass
return result
# We use a legacy scheme simply because most of the dists on PyPI use legacy
# versions which don't conform to PEP 440.
default_locator = AggregatingLocator(
# JSONLocator(), # don't use as PEP 426 is withdrawn
SimpleScrapingLocator('https://pypi.org/simple/', timeout=3.0),
scheme='legacy')
locate = default_locator.locate
class DependencyFinder(object):
"""
Locate dependencies for distributions.
"""
def __init__(self, locator=None):
"""
Initialise an instance, using the specified locator
to locate distributions.
"""
self.locator = locator or default_locator
self.scheme = get_scheme(self.locator.scheme)
def add_distribution(self, dist):
"""
Add a distribution to the finder. This will update internal information
about who provides what.
:param dist: The distribution to add.
"""
logger.debug('adding distribution %s', dist)
name = dist.key
self.dists_by_name[name] = dist
self.dists[(name, dist.version)] = dist
for p in dist.provides:
name, version = parse_name_and_version(p)
logger.debug('Add to provided: %s, %s, %s', name, version, dist)
self.provided.setdefault(name, set()).add((version, dist))
def remove_distribution(self, dist):
"""
Remove a distribution from the finder. This will update internal
information about who provides what.
:param dist: The distribution to remove.
"""
logger.debug('removing distribution %s', dist)
name = dist.key
del self.dists_by_name[name]
del self.dists[(name, dist.version)]
for p in dist.provides:
name, version = parse_name_and_version(p)
logger.debug('Remove from provided: %s, %s, %s', name, version, dist)
s = self.provided[name]
s.remove((version, dist))
if not s:
del self.provided[name]
def get_matcher(self, reqt):
"""
Get a version matcher for a requirement.
:param reqt: The requirement
:type reqt: str
:return: A version matcher (an instance of
:class:`distlib.version.Matcher`).
"""
try:
matcher = self.scheme.matcher(reqt)
except UnsupportedVersionError: # pragma: no cover
# XXX compat-mode if cannot read the version
name = reqt.split()[0]
matcher = self.scheme.matcher(name)
return matcher
def find_providers(self, reqt):
"""
Find the distributions which can fulfill a requirement.
:param reqt: The requirement.
:type reqt: str
:return: A set of distribution which can fulfill the requirement.
"""
matcher = self.get_matcher(reqt)
name = matcher.key # case-insensitive
result = set()
provided = self.provided
if name in provided:
for version, provider in provided[name]:
try:
match = matcher.match(version)
except UnsupportedVersionError:
match = False
if match:
result.add(provider)
break
return result
def try_to_replace(self, provider, other, problems):
"""
Attempt to replace one provider with another. This is typically used
when resolving dependencies from multiple sources, e.g. A requires
(B >= 1.0) while C requires (B >= 1.1).
For successful replacement, ``provider`` must meet all the requirements
which ``other`` fulfills.
:param provider: The provider we are trying to replace with.
:param other: The provider we're trying to replace.
:param problems: If False is returned, this will contain what
problems prevented replacement. This is currently
a tuple of the literal string 'cantreplace',
``provider``, ``other`` and the set of requirements
that ``provider`` couldn't fulfill.
:return: True if we can replace ``other`` with ``provider``, else
False.
"""
rlist = self.reqts[other]
unmatched = set()
for s in rlist:
matcher = self.get_matcher(s)
if not matcher.match(provider.version):
unmatched.add(s)
if unmatched:
# can't replace other with provider
problems.add(('cantreplace', provider, other, frozenset(unmatched)))
result = False
else:
# can replace other with provider
self.remove_distribution(other)
del self.reqts[other]
for s in rlist:
self.reqts.setdefault(provider, set()).add(s)
self.add_distribution(provider)
result = True
return result
def find(self, requirement, meta_extras=None, prereleases=False):
"""
Find a distribution and all distributions it depends on.
:param requirement: The requirement specifying the distribution to
find, or a Distribution instance.
:param meta_extras: A list of meta extras such as :test:, :build: and
so on.
:param prereleases: If ``True``, allow pre-release versions to be
returned - otherwise, don't return prereleases
unless they're all that's available.
Return a set of :class:`Distribution` instances and a set of
problems.
The distributions returned should be such that they have the
:attr:`required` attribute set to ``True`` if they were
from the ``requirement`` passed to ``find()``, and they have the
:attr:`build_time_dependency` attribute set to ``True`` unless they
are post-installation dependencies of the ``requirement``.
The problems should be a tuple consisting of the string
``'unsatisfied'`` and the requirement which couldn't be satisfied
by any distribution known to the locator.
"""
self.provided = {}
self.dists = {}
self.dists_by_name = {}
self.reqts = {}
meta_extras = set(meta_extras or [])
if ':*:' in meta_extras:
meta_extras.remove(':*:')
# :meta: and :run: are implicitly included
meta_extras |= set([':test:', ':build:', ':dev:'])
if isinstance(requirement, Distribution):
dist = odist = requirement
logger.debug('passed %s as requirement', odist)
else:
dist = odist = self.locator.locate(requirement, prereleases=prereleases)
if dist is None:
raise DistlibException('Unable to locate %r' % requirement)
logger.debug('located %s', odist)
dist.requested = True
problems = set()
todo = set([dist])
install_dists = set([odist])
while todo:
dist = todo.pop()
name = dist.key # case-insensitive
if name not in self.dists_by_name:
self.add_distribution(dist)
else:
# import pdb; pdb.set_trace()
other = self.dists_by_name[name]
if other != dist:
self.try_to_replace(dist, other, problems)
ireqts = dist.run_requires | dist.meta_requires
sreqts = dist.build_requires
ereqts = set()
if meta_extras and dist in install_dists:
for key in ('test', 'build', 'dev'):
e = ':%s:' % key
if e in meta_extras:
ereqts |= getattr(dist, '%s_requires' % key)
all_reqts = ireqts | sreqts | ereqts
for r in all_reqts:
providers = self.find_providers(r)
if not providers:
logger.debug('No providers found for %r', r)
provider = self.locator.locate(r, prereleases=prereleases)
# If no provider is found and we didn't consider
# prereleases, consider them now.
if provider is None and not prereleases:
provider = self.locator.locate(r, prereleases=True)
if provider is None:
logger.debug('Cannot satisfy %r', r)
problems.add(('unsatisfied', r))
else:
n, v = provider.key, provider.version
if (n, v) not in self.dists:
todo.add(provider)
providers.add(provider)
if r in ireqts and dist in install_dists:
install_dists.add(provider)
logger.debug('Adding %s to install_dists', provider.name_and_version)
for p in providers:
name = p.key
if name not in self.dists_by_name:
self.reqts.setdefault(p, set()).add(r)
else:
other = self.dists_by_name[name]
if other != p:
# see if other can be replaced by p
self.try_to_replace(p, other, problems)
dists = set(self.dists.values())
for dist in dists:
dist.build_time_dependency = dist not in install_dists
if dist.build_time_dependency:
logger.debug('%s is a build-time dependency only.', dist.name_and_version)
logger.debug('find done for %s', odist)
return dists, problems
././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1780570534.0
distlib-0.4.3/distlib/manifest.py 0000664 0001750 0001750 00000032513 15210254646 016073 0 ustar 00vinay vinay # -*- coding: utf-8 -*-
#
# Copyright (C) 2012-2026 Python Software Foundation.
# See LICENSE.txt and CONTRIBUTORS.txt.
#
"""
Class representing the list of files in a distribution.
Equivalent to distutils.filelist, but fixes some problems.
"""
import fnmatch
import logging
import os
import re
import sys
from . import DistlibException
from .compat import fsdecode
from .util import convert_path
__all__ = ['Manifest']
logger = logging.getLogger(__name__)
# a \ followed by some spaces + EOL
_COLLAPSE_PATTERN = re.compile('\\\\w*\n', re.M)
_COMMENTED_LINE = re.compile('#.*?(?=\n)|\n(?=$)', re.M | re.S)
#
# Due to the different results returned by fnmatch.translate, we need
# to do slightly different processing for Python 2.7 and 3.2 ... this needed
# to be brought in for Python 3.6 onwards.
#
_PYTHON_VERSION = sys.version_info[:2]
class Manifest(object):
"""
A list of files built by exploring the filesystem and filtered by applying various
patterns to what we find there.
"""
def __init__(self, base=None):
"""
Initialise an instance.
:param base: The base directory to explore under.
"""
self.base = os.path.abspath(os.path.normpath(base or os.getcwd()))
self.prefix = self.base + os.sep
self.allfiles = None
self.files = set()
#
# Public API
#
def findall(self):
"""Find all files under the base and set ``allfiles`` to the absolute
pathnames of files found.
"""
from stat import S_ISREG, S_ISDIR, S_ISLNK
self.allfiles = allfiles = []
root = self.base
stack = [root]
pop = stack.pop
push = stack.append
while stack:
root = pop()
names = os.listdir(root)
for name in names:
fullname = os.path.join(root, name)
# Avoid excess stat calls -- just one will do, thank you!
stat = os.lstat(fullname)
mode = stat.st_mode
if S_ISREG(mode):
allfiles.append(fsdecode(fullname))
elif S_ISDIR(mode) and not S_ISLNK(mode):
push(fullname)
def add(self, item):
"""
Add a file to the manifest.
:param item: The pathname to add. This can be relative to the base.
"""
if not item.startswith(self.prefix):
item = os.path.join(self.base, item)
self.files.add(os.path.normpath(item))
def add_many(self, items):
"""
Add a list of files to the manifest.
:param items: The pathnames to add. These can be relative to the base.
"""
for item in items:
self.add(item)
def sorted(self, wantdirs=False):
"""
Return sorted files in directory order
"""
def add_dir(dirs, d):
dirs.add(d)
logger.debug('add_dir added %s', d)
if d != self.base:
parent, _ = os.path.split(d)
assert parent not in ('', '/')
add_dir(dirs, parent)
result = set(self.files) # make a copy!
if wantdirs:
dirs = set()
for f in result:
add_dir(dirs, os.path.dirname(f))
result |= dirs
return [os.path.join(*path_tuple) for path_tuple in sorted(os.path.split(path) for path in result)]
def clear(self):
"""Clear all collected files."""
self.files = set()
self.allfiles = []
def process_directive(self, directive):
"""
Process a directive which either adds some files from ``allfiles`` to
``files``, or removes some files from ``files``.
:param directive: The directive to process. This should be in a format
compatible with distutils ``MANIFEST.in`` files:
http://docs.python.org/distutils/sourcedist.html#commands
"""
# Parse the line: split it up, make sure the right number of words
# is there, and return the relevant words. 'action' is always
# defined: it's the first word of the line. Which of the other
# three are defined depends on the action; it'll be either
# patterns, (dir and patterns), or (dirpattern).
action, patterns, thedir, dirpattern = self._parse_directive(directive)
# OK, now we know that the action is valid and we have the
# right number of words on the line for that action -- so we
# can proceed with minimal error-checking.
if action == 'include':
for pattern in patterns:
if not self._include_pattern(pattern, anchor=True):
logger.warning('no files found matching %r', pattern)
elif action == 'exclude':
for pattern in patterns:
self._exclude_pattern(pattern, anchor=True)
elif action == 'global-include':
for pattern in patterns:
if not self._include_pattern(pattern, anchor=False):
logger.warning('no files found matching %r '
'anywhere in distribution', pattern)
elif action == 'global-exclude':
for pattern in patterns:
self._exclude_pattern(pattern, anchor=False)
elif action == 'recursive-include':
for pattern in patterns:
if not self._include_pattern(pattern, prefix=thedir):
logger.warning('no files found matching %r '
'under directory %r', pattern, thedir)
elif action == 'recursive-exclude':
for pattern in patterns:
self._exclude_pattern(pattern, prefix=thedir)
elif action == 'graft':
if not self._include_pattern(None, prefix=dirpattern):
logger.warning('no directories found matching %r', dirpattern)
elif action == 'prune':
if not self._exclude_pattern(None, prefix=dirpattern):
logger.warning('no previously-included directories found '
'matching %r', dirpattern)
else: # pragma: no cover
# This should never happen, as it should be caught in
# _parse_template_line
raise DistlibException('invalid action %r' % action)
#
# Private API
#
def _parse_directive(self, directive):
"""
Validate a directive.
:param directive: The directive to validate.
:return: A tuple of action, patterns, thedir, dir_patterns
"""
words = directive.split()
if len(words) == 1 and words[0] not in ('include', 'exclude', 'global-include', 'global-exclude',
'recursive-include', 'recursive-exclude', 'graft', 'prune'):
# no action given, let's use the default 'include'
words.insert(0, 'include')
action = words[0]
patterns = thedir = dir_pattern = None
if action in ('include', 'exclude', 'global-include', 'global-exclude'):
if len(words) < 2:
raise DistlibException('%r expects ...' % action)
patterns = [convert_path(word) for word in words[1:]]
elif action in ('recursive-include', 'recursive-exclude'):
if len(words) < 3:
raise DistlibException('%r expects ...' % action)
thedir = convert_path(words[1])
patterns = [convert_path(word) for word in words[2:]]
elif action in ('graft', 'prune'):
if len(words) != 2:
raise DistlibException('%r expects a single ' % action)
dir_pattern = convert_path(words[1])
else:
raise DistlibException('unknown action %r' % action)
return action, patterns, thedir, dir_pattern
def _include_pattern(self, pattern, anchor=True, prefix=None, is_regex=False):
"""Select strings (presumably filenames) from 'self.files' that
match 'pattern', a Unix-style wildcard (glob) pattern.
Patterns are not quite the same as implemented by the 'fnmatch'
module: '*' and '?' match non-special characters, where "special"
is platform-dependent: slash on Unix; colon, slash, and backslash on
DOS/Windows; and colon on Mac OS.
If 'anchor' is true (the default), then the pattern match is more
stringent: "*.py" will match "foo.py" but not "foo/bar.py". If
'anchor' is false, both of these will match.
If 'prefix' is supplied, then only filenames starting with 'prefix'
(itself a pattern) and ending with 'pattern', with anything in between
them, will match. 'anchor' is ignored in this case.
If 'is_regex' is true, 'anchor' and 'prefix' are ignored, and
'pattern' is assumed to be either a string containing a regex or a
regex object -- no translation is done, the regex is just compiled
and used as-is.
Selected strings will be added to self.files.
Return True if files are found.
"""
# XXX docstring lying about what the special chars are?
found = False
pattern_re = self._translate_pattern(pattern, anchor, prefix, is_regex)
# delayed loading of allfiles list
if self.allfiles is None:
self.findall()
for name in self.allfiles:
if pattern_re.search(name):
self.files.add(name)
found = True
return found
def _exclude_pattern(self, pattern, anchor=True, prefix=None, is_regex=False):
"""Remove strings (presumably filenames) from 'files' that match
'pattern'.
Other parameters are the same as for 'include_pattern()', above.
The list 'self.files' is modified in place. Return True if files are
found.
This API is public to allow e.g. exclusion of SCM subdirs, e.g. when
packaging source distributions
"""
found = False
pattern_re = self._translate_pattern(pattern, anchor, prefix, is_regex)
for f in list(self.files):
if pattern_re.search(f):
self.files.remove(f)
found = True
return found
def _translate_pattern(self, pattern, anchor=True, prefix=None, is_regex=False):
"""Translate a shell-like wildcard pattern to a compiled regular
expression.
Return the compiled regex. If 'is_regex' true,
then 'pattern' is directly compiled to a regex (if it's a string)
or just returned as-is (assumes it's a regex object).
"""
if is_regex:
if isinstance(pattern, str):
return re.compile(pattern)
else:
return pattern
if _PYTHON_VERSION > (3, 2):
# ditch start and end characters
start, _, end = self._glob_to_re('_').partition('_')
if pattern:
pattern_re = self._glob_to_re(pattern)
if _PYTHON_VERSION > (3, 2):
assert pattern_re.startswith(start) and pattern_re.endswith(end)
else:
pattern_re = ''
base = re.escape(os.path.join(self.base, ''))
if prefix is not None:
# ditch end of pattern character
if _PYTHON_VERSION <= (3, 2):
empty_pattern = self._glob_to_re('')
prefix_re = self._glob_to_re(prefix)[:-len(empty_pattern)]
else:
prefix_re = self._glob_to_re(prefix)
assert prefix_re.startswith(start) and prefix_re.endswith(end)
prefix_re = prefix_re[len(start):len(prefix_re) - len(end)]
sep = os.sep
if os.sep == '\\':
sep = r'\\'
if _PYTHON_VERSION <= (3, 2):
pattern_re = '^' + base + sep.join((prefix_re, '.*' + pattern_re))
else:
pattern_re = pattern_re[len(start):len(pattern_re) - len(end)]
pattern_re = r'%s%s%s%s.*%s%s' % (start, base, prefix_re, sep, pattern_re, end)
else: # no prefix -- respect anchor flag
if anchor:
if _PYTHON_VERSION <= (3, 2):
pattern_re = '^' + base + pattern_re
else:
pattern_re = r'%s%s%s' % (start, base, pattern_re[len(start):])
return re.compile(pattern_re)
def _glob_to_re(self, pattern):
"""Translate a shell-like glob pattern to a regular expression.
Return a string containing the regex. Differs from
'fnmatch.translate()' in that '*' does not match "special characters"
(which are platform-specific).
"""
pattern_re = fnmatch.translate(pattern)
# '?' and '*' in the glob pattern become '.' and '.*' in the RE, which
# IMHO is wrong -- '?' and '*' aren't supposed to match slash in Unix,
# and by extension they shouldn't match such "special characters" under
# any OS. So change all non-escaped dots in the RE to match any
# character except the special characters (currently: just os.sep).
sep = os.sep
if os.sep == '\\':
# we're using a regex to manipulate a regex, so we need
# to escape the backslash twice
sep = r'\\\\'
escaped = r'\1[^%s]' % sep
pattern_re = re.sub(r'((? y,
'!=': lambda x, y: x != y,
'<': lambda x, y: x < y,
'<=': lambda x, y: x == y or x < y,
'>': lambda x, y: x > y,
'>=': lambda x, y: x == y or x > y,
'and': lambda x, y: x and y,
'or': lambda x, y: x or y,
'in': lambda x, y: x in y,
'not in': lambda x, y: x not in y,
}
def evaluate(self, expr, context):
"""
Evaluate a marker expression returned by the :func:`parse_requirement`
function in the specified context.
"""
if isinstance(expr, string_types):
if expr[0] in '\'"':
result = expr[1:-1]
else:
if expr not in context:
raise SyntaxError('unknown variable: %s' % expr)
result = context[expr]
else:
assert isinstance(expr, dict)
op = expr['op']
if op not in self.operations:
raise NotImplementedError('op not implemented: %s' % op)
elhs = expr['lhs']
erhs = expr['rhs']
if _is_literal(expr['lhs']) and _is_literal(expr['rhs']):
raise SyntaxError('invalid comparison: %s %s %s' % (elhs, op, erhs))
lhs = self.evaluate(elhs, context)
rhs = self.evaluate(erhs, context)
if ((_is_version_marker(elhs) or _is_version_marker(erhs)) and
op in ('<', '<=', '>', '>=', '===', '==', '!=', '~=')):
lhs = LV(lhs)
rhs = LV(rhs)
elif _is_version_marker(elhs) and op in ('in', 'not in'):
lhs = LV(lhs)
rhs = _get_versions(rhs)
result = self.operations[op](lhs, rhs)
return result
_DIGITS = re.compile(r'\d+\.\d+')
def default_context():
def format_full_version(info):
version = '%s.%s.%s' % (info.major, info.minor, info.micro)
kind = info.releaselevel
if kind != 'final':
version += kind[0] + str(info.serial)
return version
if hasattr(sys, 'implementation'):
implementation_version = format_full_version(sys.implementation.version)
implementation_name = sys.implementation.name
else:
implementation_version = '0'
implementation_name = ''
ppv = platform.python_version()
m = _DIGITS.match(ppv)
pv = m.group(0)
result = {
'implementation_name': implementation_name,
'implementation_version': implementation_version,
'os_name': os.name,
'platform_machine': platform.machine(),
'platform_python_implementation': platform.python_implementation(),
'platform_release': platform.release(),
'platform_system': platform.system(),
'platform_version': platform.version(),
'platform_in_venv': str(in_venv()),
'python_full_version': ppv,
'python_version': pv,
'sys_platform': sys.platform,
}
return result
DEFAULT_CONTEXT = default_context()
del default_context
evaluator = Evaluator()
def interpret_parsed(expr, execution_context=None):
context = dict(DEFAULT_CONTEXT)
if execution_context:
context.update(execution_context)
return evaluator.evaluate(expr, context)
def interpret(marker, execution_context=None):
"""
Interpret a marker and return a result depending on environment.
:param marker: The marker to interpret.
:type marker: str
:param execution_context: The context used for name lookup.
:type execution_context: mapping
"""
try:
expr, rest = parse_marker(marker)
except Exception as e:
raise SyntaxError('Unable to interpret marker syntax: %s: %s' % (marker, e))
if rest and rest[0] != '#':
raise SyntaxError('unexpected trailing data in marker: %s: %s' % (marker, rest))
return interpret_parsed(expr, execution_context)
././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1780732793.0
distlib-0.4.3/distlib/metadata.py 0000664 0001750 0001750 00000115175 15210751571 016052 0 ustar 00vinay vinay # -*- coding: utf-8 -*-
#
# Copyright (C) 2012-2026 The Python Software Foundation.
# See LICENSE.txt and CONTRIBUTORS.txt.
#
"""Implementation of the Metadata for Python packages PEPs.
Supports metadata formats 1.0, 1.1, 1.2, 1.3/2.1, 2.2, 2,3, 2.4, 2.5.
"""
from __future__ import unicode_literals
import codecs
from email import message_from_file
import json
import logging
import re
from . import DistlibException, __version__
from .compat import StringIO, string_types, text_type
from .markers import interpret
from .util import extract_by_key, get_extras
from .version import get_scheme, PEP440_VERSION_RE
logger = logging.getLogger(__name__)
class MetadataMissingError(DistlibException):
"""A required metadata is missing"""
class MetadataConflictError(DistlibException):
"""Attempt to read or write metadata fields that are conflictual."""
class MetadataUnrecognizedVersionError(DistlibException):
"""Unknown metadata version number."""
class MetadataInvalidError(DistlibException):
"""A metadata value is invalid"""
# public API of this module
__all__ = ['Metadata', 'PKG_INFO_ENCODING', 'PKG_INFO_PREFERRED_VERSION']
# Encoding used for the PKG-INFO files
PKG_INFO_ENCODING = 'utf-8'
# preferred version. Hopefully will be changed
# to 1.2 once PEP 345 is supported everywhere
PKG_INFO_PREFERRED_VERSION = '1.1'
_LINE_PREFIX_1_2 = re.compile('\n \\|')
_LINE_PREFIX_PRE_1_2 = re.compile('\n ')
_241_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform', 'Summary', 'Description', 'Keywords', 'Home-page',
'Author', 'Author-email', 'License')
_314_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform', 'Supported-Platform', 'Summary', 'Description',
'Keywords', 'Home-page', 'Author', 'Author-email', 'License', 'Classifier', 'Download-URL', 'Obsoletes',
'Provides', 'Requires')
_314_MARKERS = ('Obsoletes', 'Provides', 'Requires', 'Classifier', 'Download-URL')
_345_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform', 'Supported-Platform', 'Summary', 'Description',
'Keywords', 'Home-page', 'Author', 'Author-email', 'Maintainer', 'Maintainer-email', 'License',
'Classifier', 'Download-URL', 'Obsoletes-Dist', 'Project-URL', 'Provides-Dist', 'Requires-Dist',
'Requires-Python', 'Requires-External')
_345_MARKERS = ('Provides-Dist', 'Requires-Dist', 'Requires-Python', 'Obsoletes-Dist', 'Requires-External',
'Maintainer', 'Maintainer-email', 'Project-URL')
_426_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform', 'Supported-Platform', 'Summary', 'Description',
'Keywords', 'Home-page', 'Author', 'Author-email', 'Maintainer', 'Maintainer-email', 'License',
'Classifier', 'Download-URL', 'Obsoletes-Dist', 'Project-URL', 'Provides-Dist', 'Requires-Dist',
'Requires-Python', 'Requires-External', 'Private-Version', 'Obsoleted-By', 'Setup-Requires-Dist',
'Extension', 'Provides-Extra')
_426_MARKERS = ('Private-Version', 'Provides-Extra', 'Obsoleted-By', 'Setup-Requires-Dist', 'Extension')
# See issue #106: Sometimes 'Requires' and 'Provides' occur wrongly in
# the metadata. Include them in the tuple literal below to allow them
# (for now).
# Ditto for Obsoletes - see issue #140.
_566_FIELDS = _426_FIELDS + ('Description-Content-Type', 'Requires', 'Provides', 'Obsoletes')
_566_MARKERS = ('Description-Content-Type', )
_643_MARKERS = ('Dynamic',)
_643_FIELDS = _566_FIELDS + _643_MARKERS
_639_MARKERS = ('License-Expression', 'License-File')
_639_FIELDS = _643_FIELDS + _639_MARKERS
_794_MARKERS = ('Import-Name', 'Import-Namespace')
_794_FIELDS = _639_FIELDS + _794_MARKERS
_ALL_FIELDS = set()
_ALL_FIELDS.update(_241_FIELDS)
_ALL_FIELDS.update(_314_FIELDS)
_ALL_FIELDS.update(_345_FIELDS)
_ALL_FIELDS.update(_426_FIELDS)
_ALL_FIELDS.update(_566_FIELDS)
_ALL_FIELDS.update(_643_FIELDS)
_ALL_FIELDS.update(_639_FIELDS)
_ALL_FIELDS.update(_794_FIELDS)
EXTRA_RE = re.compile(r'''extra\s*==\s*("([^"]+)"|'([^']+)')''')
def _version2fieldlist(version):
if version == '1.0':
return _241_FIELDS
elif version == '1.1':
return _314_FIELDS
elif version == '1.2':
return _345_FIELDS
elif version in ('1.3', '2.1'):
# avoid adding field names if already there
return _345_FIELDS + tuple(f for f in _566_FIELDS if f not in _345_FIELDS)
elif version == '2.0':
raise ValueError('Metadata 2.0 is withdrawn and not supported')
# return _426_FIELDS
elif version in ('2.2', '2.3'):
return _643_FIELDS
elif version == '2.4':
return _639_FIELDS
elif version == '2.5':
return _794_FIELDS
raise MetadataUnrecognizedVersionError(version)
def _best_version(fields):
"""Detect the best version depending on the fields used."""
def _has_marker(keys, markers):
return any(marker in keys for marker in markers)
keys = [key for key, value in fields.items() if value not in ([], 'UNKNOWN', None)]
possible_versions = ['1.0', '1.1', '1.2', '1.3', '2.1', '2.2', '2.4', '2.5'] # 2.0 removed
# first let's try to see if a field is not part of one of the version
for key in keys:
if key not in _241_FIELDS and '1.0' in possible_versions:
possible_versions.remove('1.0')
logger.debug('Removed 1.0 due to %s', key)
if key not in _314_FIELDS and '1.1' in possible_versions:
possible_versions.remove('1.1')
logger.debug('Removed 1.1 due to %s', key)
if key not in _345_FIELDS and '1.2' in possible_versions:
possible_versions.remove('1.2')
logger.debug('Removed 1.2 due to %s', key)
if key not in _566_FIELDS and '1.3' in possible_versions:
possible_versions.remove('1.3')
logger.debug('Removed 1.3 due to %s', key)
if key not in _566_FIELDS and '2.1' in possible_versions:
if key != 'Description': # In 2.1, description allowed after headers
possible_versions.remove('2.1')
logger.debug('Removed 2.1 due to %s', key)
if key not in _643_FIELDS and '2.2' in possible_versions:
possible_versions.remove('2.2')
logger.debug('Removed 2.2 due to %s', key)
if key not in _639_FIELDS and '2.4' in possible_versions:
possible_versions.remove('2.4')
logger.debug('Removed 2.4 due to %s', key)
if key not in _794_FIELDS and '2.5' in possible_versions:
possible_versions.remove('2.5')
logger.debug('Removed 2.5 due to %s', key)
# possible_version contains qualified versions
if len(possible_versions) == 1:
return possible_versions[0] # found !
elif len(possible_versions) == 0:
logger.debug('Out of options - unknown metadata set: %s', fields)
raise MetadataConflictError('Unknown metadata set')
# let's see if one unique marker is found
is_1_1 = '1.1' in possible_versions and _has_marker(keys, _314_MARKERS)
is_1_2 = '1.2' in possible_versions and _has_marker(keys, _345_MARKERS)
is_2_1 = '2.1' in possible_versions and _has_marker(keys, _566_MARKERS)
# is_2_0 = '2.0' in possible_versions and _has_marker(keys, _426_MARKERS)
is_2_2 = '2.2' in possible_versions and _has_marker(keys, _643_MARKERS)
is_2_4 = '2.4' in possible_versions and _has_marker(keys, _639_MARKERS)
is_2_5 = '2.5' in possible_versions and _has_marker(keys, _794_MARKERS)
if int(is_1_1) + int(is_1_2) + int(is_2_1) + int(is_2_2) + int(is_2_4) + int(is_2_5) > 1:
raise MetadataConflictError('You used incompatible 1.1/1.2/2.1/2.2/2.4/2.5 fields')
# we have the choice, 1.0, or 1.2, 2.1, 2.2, 2.4 or 2.5
# - 1.0 has a broken Summary field but works with all tools
# - 1.1 is to avoid
# - 1.2 fixes Summary but has little adoption
# - 2.1 adds more features
# - 2.5 is the latest
if not (is_1_1 or is_1_2 or is_2_1 or is_2_2 or is_2_4 or is_2_5):
# we couldn't find any specific marker
if PKG_INFO_PREFERRED_VERSION in possible_versions:
return PKG_INFO_PREFERRED_VERSION
if is_1_1:
return '1.1'
if is_1_2:
return '1.2'
if is_2_1:
return '2.1'
if is_2_2:
return '2.2'
if is_2_4:
return '2.4'
return '2.5'
# This follows the rules about transforming keys as described in
# https://www.python.org/dev/peps/pep-0566/#id17
_ATTR2FIELD = {name.lower().replace("-", "_"): name for name in _ALL_FIELDS}
_FIELD2ATTR = {field: attr for attr, field in _ATTR2FIELD.items()}
_PREDICATE_FIELDS = ('Requires-Dist', 'Obsoletes-Dist', 'Provides-Dist')
_VERSIONS_FIELDS = ('Requires-Python', )
_VERSION_FIELDS = ('Version', )
_LISTFIELDS = ('Platform', 'Classifier', 'Obsoletes', 'Requires', 'Provides', 'Obsoletes-Dist', 'Provides-Dist',
'Requires-Dist', 'Requires-External', 'Project-URL', 'Supported-Platform', 'Setup-Requires-Dist',
'Provides-Extra', 'Extension', 'License-File', 'Import-Name', 'Import-Namespace')
_LISTTUPLEFIELDS = ('Project-URL', )
_ELEMENTSFIELD = ('Keywords', )
_UNICODEFIELDS = ('Author', 'Maintainer', 'Summary', 'Description')
_MISSING = object()
_FILESAFE = re.compile('[^A-Za-z0-9.]+')
def _get_name_and_version(name, version, for_filename=False):
"""Return the distribution name with version.
If for_filename is true, return a filename-escaped form."""
if for_filename:
# For both name and version any runs of non-alphanumeric or '.'
# characters are replaced with a single '-'. Additionally any
# spaces in the version string become '.'
name = _FILESAFE.sub('-', name)
version = _FILESAFE.sub('-', version.replace(' ', '.'))
return '%s-%s' % (name, version)
class LegacyMetadata(object):
"""The legacy metadata of a release.
Supports versions 1.0, 1.1, 1.2, 2.0 and 1.3/2.1 (auto-detected). You can
instantiate the class with one of these arguments (or none):
- *path*, the path to a metadata file
- *fileobj* give a file-like object with metadata as content
- *mapping* is a dict-like object
- *scheme* is a version scheme name
"""
# TODO document the mapping API and UNKNOWN default key
def __init__(self, path=None, fileobj=None, mapping=None, scheme='default'):
if [path, fileobj, mapping].count(None) < 2:
raise TypeError('path, fileobj and mapping are exclusive')
self._fields = {}
self.requires_files = []
self._dependencies = None
self.scheme = scheme
if path is not None:
self.read(path)
elif fileobj is not None:
self.read_file(fileobj)
elif mapping is not None:
self.update(mapping)
self.set_metadata_version()
def set_metadata_version(self):
self._fields['Metadata-Version'] = _best_version(self._fields)
def _write_field(self, fileobj, name, value):
fileobj.write('%s: %s\n' % (name, value))
def __getitem__(self, name):
return self.get(name)
def __setitem__(self, name, value):
return self.set(name, value)
def __delitem__(self, name):
field_name = self._convert_name(name)
try:
del self._fields[field_name]
except KeyError:
raise KeyError(name)
def __contains__(self, name):
return (name in self._fields or self._convert_name(name) in self._fields)
def _convert_name(self, name):
if name in _ALL_FIELDS:
return name
name = name.replace('-', '_').lower()
return _ATTR2FIELD.get(name, name)
def _default_value(self, name):
if name in _LISTFIELDS or name in _ELEMENTSFIELD:
return []
return 'UNKNOWN'
def _remove_line_prefix(self, value):
if self.metadata_version in ('1.0', '1.1'):
return _LINE_PREFIX_PRE_1_2.sub('\n', value)
else:
return _LINE_PREFIX_1_2.sub('\n', value)
def __getattr__(self, name):
if name in _ATTR2FIELD:
return self[name]
raise AttributeError(name)
#
# Public API
#
def get_fullname(self, filesafe=False):
"""
Return the distribution name with version.
If filesafe is true, return a filename-escaped form.
"""
return _get_name_and_version(self['Name'], self['Version'], filesafe)
def is_field(self, name):
"""return True if name is a valid metadata key"""
name = self._convert_name(name)
return name in _ALL_FIELDS
def is_multi_field(self, name):
name = self._convert_name(name)
return name in _LISTFIELDS
def read(self, filepath):
"""Read the metadata values from a file path."""
fp = codecs.open(filepath, 'r', encoding='utf-8')
try:
self.read_file(fp)
finally:
fp.close()
def read_file(self, fileob):
"""Read the metadata values from a file object."""
msg = message_from_file(fileob)
self._fields['Metadata-Version'] = msg['metadata-version']
# When reading, get all the fields we can
for field in _ALL_FIELDS:
if field not in msg:
continue
if field in _LISTFIELDS:
# we can have multiple lines
values = msg.get_all(field)
if field in _LISTTUPLEFIELDS and values is not None:
values = [tuple(value.split(',')) for value in values]
self.set(field, values)
else:
# single line
value = msg[field]
if value is not None and value != 'UNKNOWN':
self.set(field, value)
# PEP 566 specifies that the body be used for the description, if
# available
body = msg.get_payload()
self["Description"] = body if body else self["Description"]
# logger.debug('Attempting to set metadata for %s', self)
# self.set_metadata_version()
def write(self, filepath, skip_unknown=False):
"""Write the metadata fields to filepath."""
fp = codecs.open(filepath, 'w', encoding='utf-8')
try:
self.write_file(fp, skip_unknown)
finally:
fp.close()
def write_file(self, fileobject, skip_unknown=False):
"""Write the PKG-INFO format data to a file object."""
self.set_metadata_version()
for field in _version2fieldlist(self['Metadata-Version']):
values = self.get(field)
if skip_unknown and values in ('UNKNOWN', [], ['UNKNOWN']):
continue
if field in _ELEMENTSFIELD:
self._write_field(fileobject, field, ','.join(values))
continue
if field not in _LISTFIELDS:
if field == 'Description':
if self.metadata_version in ('1.0', '1.1'):
values = values.replace('\n', '\n ')
else:
values = values.replace('\n', '\n |')
values = [values]
if field in _LISTTUPLEFIELDS:
values = [','.join(value) for value in values]
for value in values:
self._write_field(fileobject, field, value)
def update(self, other=None, **kwargs):
"""Set metadata values from the given iterable `other` and kwargs.
Behavior is like `dict.update`: If `other` has a ``keys`` method,
they are looped over and ``self[key]`` is assigned ``other[key]``.
Else, ``other`` is an iterable of ``(key, value)`` iterables.
Keys that don't match a metadata field or that have an empty value are
dropped.
"""
def _set(key, value):
if key in _ATTR2FIELD and value:
self.set(self._convert_name(key), value)
if not other:
# other is None or empty container
pass
elif hasattr(other, 'keys'):
for k in other.keys():
_set(k, other[k])
else:
for k, v in other:
_set(k, v)
if kwargs:
for k, v in kwargs.items():
_set(k, v)
def set(self, name, value):
"""Control then set a metadata field."""
name = self._convert_name(name)
if ((name in _ELEMENTSFIELD or name == 'Platform') and not isinstance(value, (list, tuple))):
if isinstance(value, string_types):
value = [v.strip() for v in value.split(',')]
else:
value = []
elif (name in _LISTFIELDS and not isinstance(value, (list, tuple))):
if isinstance(value, string_types):
value = [value]
else:
value = []
if logger.isEnabledFor(logging.WARNING):
project_name = self['Name']
scheme = get_scheme(self.scheme)
if name in _PREDICATE_FIELDS and value is not None:
for v in value:
# check that the values are valid
if not scheme.is_valid_matcher(v.split(';')[0]):
logger.warning("'%s': '%s' is not valid (field '%s')", project_name, v, name)
# FIXME this rejects UNKNOWN, is that right?
elif name in _VERSIONS_FIELDS and value is not None:
if not scheme.is_valid_constraint_list(value):
logger.warning("'%s': '%s' is not a valid version (field '%s')", project_name, value, name)
elif name in _VERSION_FIELDS and value is not None:
if not scheme.is_valid_version(value):
logger.warning("'%s': '%s' is not a valid version (field '%s')", project_name, value, name)
if name in _UNICODEFIELDS:
if name == 'Description':
value = self._remove_line_prefix(value)
self._fields[name] = value
def get(self, name, default=_MISSING):
"""Get a metadata field."""
name = self._convert_name(name)
if name not in self._fields:
if default is _MISSING:
default = self._default_value(name)
return default
if name in _UNICODEFIELDS:
value = self._fields[name]
return value
elif name in _LISTFIELDS:
value = self._fields[name]
if value is None:
return []
res = []
for val in value:
if name not in _LISTTUPLEFIELDS:
res.append(val)
else:
# That's for Project-URL
res.append((val[0], val[1]))
return res
elif name in _ELEMENTSFIELD:
value = self._fields[name]
if isinstance(value, string_types):
return value.split(',')
return self._fields[name]
def check(self, strict=False):
"""Check if the metadata is compliant. If strict is True then raise if
no Name or Version are provided"""
self.set_metadata_version()
# XXX should check the versions (if the file was loaded)
missing, warnings = [], []
for attr in ('Name', 'Version'): # required by PEP 345
if attr not in self:
missing.append(attr)
if strict and missing != []:
msg = 'missing required metadata: %s' % ', '.join(missing)
raise MetadataMissingError(msg)
for attr in ('Home-page', 'Author'):
if attr not in self:
missing.append(attr)
# checking metadata 1.2 (XXX needs to check 1.1, 1.0)
if self['Metadata-Version'] != '1.2':
return missing, warnings
scheme = get_scheme(self.scheme)
def are_valid_constraints(value):
for v in value:
if not scheme.is_valid_matcher(v.split(';')[0]):
return False
return True
for fields, controller in ((_PREDICATE_FIELDS, are_valid_constraints),
(_VERSIONS_FIELDS, scheme.is_valid_constraint_list), (_VERSION_FIELDS,
scheme.is_valid_version)):
for field in fields:
value = self.get(field, None)
if value is not None and not controller(value):
warnings.append("Wrong value for '%s': %s" % (field, value))
return missing, warnings
def todict(self, skip_missing=False):
"""Return fields as a dict.
Field names will be converted to use the underscore-lowercase style
instead of hyphen-mixed case (i.e. home_page instead of Home-page).
This is as per https://www.python.org/dev/peps/pep-0566/#id17.
"""
self.set_metadata_version()
fields = _version2fieldlist(self['Metadata-Version'])
data = {}
for field_name in fields:
if not skip_missing or field_name in self._fields:
key = _FIELD2ATTR[field_name]
if key != 'project_url':
data[key] = self[field_name]
else:
data[key] = [','.join(u) for u in self[field_name]]
return data
def add_requirements(self, requirements):
if self['Metadata-Version'] == '1.1':
# we can't have 1.1 metadata *and* Setuptools requires
for field in ('Obsoletes', 'Requires', 'Provides'):
if field in self:
del self[field]
self['Requires-Dist'] += requirements
# Mapping API
# TODO could add iter* variants
def keys(self):
return list(_version2fieldlist(self['Metadata-Version']))
def __iter__(self):
for key in self.keys():
yield key
def values(self):
return [self[key] for key in self.keys()]
def items(self):
return [(key, self[key]) for key in self.keys()]
def __repr__(self):
return '<%s %s %s>' % (self.__class__.__name__, self.name, self.version)
METADATA_FILENAME = 'pydist.json'
WHEEL_METADATA_FILENAME = 'metadata.json'
LEGACY_METADATA_FILENAME = 'METADATA'
class Metadata(object):
"""
The metadata of a release. This implementation uses 2.1
metadata where possible. If not possible, it wraps a LegacyMetadata
instance which handles the key-value metadata format.
"""
METADATA_VERSION_MATCHER = re.compile(r'^\d+(\.\d+)*$')
NAME_MATCHER = re.compile('^[0-9A-Z]([0-9A-Z_.-]*[0-9A-Z])?$', re.I)
FIELDNAME_MATCHER = re.compile('^[A-Z]([0-9A-Z-]*[0-9A-Z])?$', re.I)
VERSION_MATCHER = PEP440_VERSION_RE
SUMMARY_MATCHER = re.compile('.{1,2047}')
METADATA_VERSION = '2.0'
GENERATOR = 'distlib (%s)' % __version__
MANDATORY_KEYS = {
'name': (),
'version': (),
'summary': ('legacy', ),
}
INDEX_KEYS = ('name version license summary description author '
'author_email keywords platform home_page classifiers '
'download_url')
DEPENDENCY_KEYS = ('extras run_requires test_requires build_requires '
'dev_requires provides meta_requires obsoleted_by '
'supports_environments')
SYNTAX_VALIDATORS = {
'metadata_version': (METADATA_VERSION_MATCHER, ()),
'name': (NAME_MATCHER, ('legacy', )),
'version': (VERSION_MATCHER, ('legacy', )),
'summary': (SUMMARY_MATCHER, ('legacy', )),
'dynamic': (FIELDNAME_MATCHER, ('legacy', )),
}
__slots__ = ('_legacy', '_data', 'scheme')
def __init__(self, path=None, fileobj=None, mapping=None, scheme='default'):
if [path, fileobj, mapping].count(None) < 2:
raise TypeError('path, fileobj and mapping are exclusive')
self._legacy = None
self._data = None
self.scheme = scheme
# import pdb; pdb.set_trace()
if mapping is not None:
try:
self._validate_mapping(mapping, scheme)
self._data = mapping
except MetadataUnrecognizedVersionError:
self._legacy = LegacyMetadata(mapping=mapping, scheme=scheme)
self.validate()
else:
data = None
if path:
with open(path, 'rb') as f:
data = f.read()
elif fileobj:
data = fileobj.read()
if data is None:
# Initialised with no args - to be added
self._data = {
'metadata_version': self.METADATA_VERSION,
'generator': self.GENERATOR,
}
else:
if not isinstance(data, text_type):
data = data.decode('utf-8')
try:
self._data = json.loads(data)
self._validate_mapping(self._data, scheme)
except ValueError:
# Note: MetadataUnrecognizedVersionError does not
# inherit from ValueError (it's a DistlibException,
# which should not inherit from ValueError).
# The ValueError comes from the json.load - if that
# succeeds and we get a validation error, we want
# that to propagate
self._legacy = LegacyMetadata(fileobj=StringIO(data), scheme=scheme)
self.validate()
common_keys = set(('name', 'version', 'license', 'keywords', 'summary'))
none_list = (None, list)
none_dict = (None, dict)
mapped_keys = {
'run_requires': ('Requires-Dist', list),
'build_requires': ('Setup-Requires-Dist', list),
'dev_requires': none_list,
'test_requires': none_list,
'meta_requires': none_list,
'extras': ('Provides-Extra', list),
'modules': none_list,
'namespaces': none_list,
'exports': none_dict,
'commands': none_dict,
'classifiers': ('Classifier', list),
'source_url': ('Download-URL', None),
'metadata_version': ('Metadata-Version', None),
}
del none_list, none_dict
def __getattribute__(self, key):
common = object.__getattribute__(self, 'common_keys')
mapped = object.__getattribute__(self, 'mapped_keys')
if key in mapped:
lk, maker = mapped[key]
if self._legacy:
if lk is None:
result = None if maker is None else maker()
else:
result = self._legacy.get(lk)
else:
value = None if maker is None else maker()
if key not in ('commands', 'exports', 'modules', 'namespaces', 'classifiers'):
result = self._data.get(key, value)
else:
# special cases for PEP 459
sentinel = object()
result = sentinel
d = self._data.get('extensions')
if d:
if key == 'commands':
result = d.get('python.commands', value)
elif key == 'classifiers':
d = d.get('python.details')
if d:
result = d.get(key, value)
else:
d = d.get('python.exports')
if not d:
d = self._data.get('python.exports')
if d:
result = d.get(key, value)
if result is sentinel:
result = value
elif key not in common:
result = object.__getattribute__(self, key)
elif self._legacy:
result = self._legacy.get(key)
else:
result = self._data.get(key)
return result
def _validate_value(self, key, value, scheme=None):
if key in self.SYNTAX_VALIDATORS:
pattern, exclusions = self.SYNTAX_VALIDATORS[key]
if (scheme or self.scheme) not in exclusions:
m = pattern.match(value)
if not m:
raise MetadataInvalidError("'%s' is an invalid value for "
"the '%s' property" % (value, key))
def __setattr__(self, key, value):
self._validate_value(key, value)
common = object.__getattribute__(self, 'common_keys')
mapped = object.__getattribute__(self, 'mapped_keys')
if key in mapped:
lk, _ = mapped[key]
if self._legacy:
if lk is None:
raise NotImplementedError
self._legacy[lk] = value
elif key not in ('commands', 'exports', 'modules', 'namespaces', 'classifiers'):
self._data[key] = value
else:
# special cases for PEP 459
d = self._data.setdefault('extensions', {})
if key == 'commands':
d['python.commands'] = value
elif key == 'classifiers':
d = d.setdefault('python.details', {})
d[key] = value
else:
d = d.setdefault('python.exports', {})
d[key] = value
elif key not in common:
object.__setattr__(self, key, value)
else:
if key == 'keywords':
if isinstance(value, string_types):
value = value.strip()
if value:
value = value.split()
else:
value = []
if self._legacy:
self._legacy[key] = value
else:
self._data[key] = value
@property
def name_and_version(self):
return _get_name_and_version(self.name, self.version, True)
@property
def provides(self):
if self._legacy:
result = self._legacy['Provides-Dist']
else:
result = self._data.setdefault('provides', [])
s = '%s (%s)' % (self.name, self.version)
if s not in result:
result.append(s)
return result
@provides.setter
def provides(self, value):
if self._legacy:
self._legacy['Provides-Dist'] = value
else:
self._data['provides'] = value
def get_requirements(self, reqts, extras=None, env=None):
"""
Base method to get dependencies, given a set of extras
to satisfy and an optional environment context.
:param reqts: A list of sometimes-wanted dependencies,
perhaps dependent on extras and environment.
:param extras: A list of optional components being requested.
:param env: An optional environment for marker evaluation.
"""
if self._legacy:
result = reqts
else:
result = []
extras = get_extras(extras or [], self.extras)
for d in reqts:
if 'extra' not in d and 'environment' not in d:
# unconditional
include = True
else:
if 'extra' not in d:
# Not extra-dependent - only environment-dependent
include = True
else:
include = d.get('extra') in extras
if include:
# Not excluded because of extras, check environment
marker = d.get('environment')
if marker:
include = interpret(marker, env)
if include:
result.extend(d['requires'])
for key in ('build', 'dev', 'test'):
e = ':%s:' % key
if e in extras:
extras.remove(e)
# A recursive call, but it should terminate since 'test'
# has been removed from the extras
reqts = self._data.get('%s_requires' % key, [])
result.extend(self.get_requirements(reqts, extras=extras, env=env))
return result
@property
def dictionary(self):
if self._legacy:
return self._from_legacy()
return self._data
@property
def dependencies(self):
if self._legacy:
raise NotImplementedError
else:
return extract_by_key(self._data, self.DEPENDENCY_KEYS)
@dependencies.setter
def dependencies(self, value):
if self._legacy:
raise NotImplementedError
else:
self._data.update(value)
def _validate_mapping(self, mapping, scheme):
if mapping.get('metadata_version') != self.METADATA_VERSION:
raise MetadataUnrecognizedVersionError()
missing = []
for key, exclusions in self.MANDATORY_KEYS.items():
if key not in mapping:
if scheme not in exclusions:
missing.append(key)
if missing:
msg = 'Missing metadata items: %s' % ', '.join(missing)
raise MetadataMissingError(msg)
for k, v in mapping.items():
self._validate_value(k, v, scheme)
def validate(self):
if self._legacy:
missing, warnings = self._legacy.check(True)
if missing or warnings:
logger.warning('Metadata: missing: %s, warnings: %s', missing, warnings)
else:
self._validate_mapping(self._data, self.scheme)
def todict(self):
if self._legacy:
return self._legacy.todict(True)
else:
result = extract_by_key(self._data, self.INDEX_KEYS)
return result
def _from_legacy(self):
assert self._legacy and not self._data
result = {
'metadata_version': self.METADATA_VERSION,
'generator': self.GENERATOR,
}
lmd = self._legacy.todict(True) # skip missing ones
for k in ('name', 'version', 'license', 'summary', 'description', 'classifier'):
if k in lmd:
if k == 'classifier':
nk = 'classifiers'
else:
nk = k
result[nk] = lmd[k]
kw = lmd.get('Keywords', [])
if kw == ['']:
kw = []
result['keywords'] = kw
keys = (('requires_dist', 'run_requires'), ('setup_requires_dist', 'build_requires'))
for ok, nk in keys:
if ok in lmd and lmd[ok]:
result[nk] = [{'requires': lmd[ok]}]
result['provides'] = self.provides
# author = {}
# maintainer = {}
return result
LEGACY_MAPPING = {
'name': 'Name',
'version': 'Version',
('extensions', 'python.details', 'license'): 'License',
'summary': 'Summary',
'description': 'Description',
('extensions', 'python.project', 'project_urls', 'Home'): 'Home-page',
('extensions', 'python.project', 'contacts', 0, 'name'): 'Author',
('extensions', 'python.project', 'contacts', 0, 'email'): 'Author-email',
'source_url': 'Download-URL',
('extensions', 'python.details', 'classifiers'): 'Classifier',
}
def _to_legacy(self):
def process_entries(entries):
reqts = set()
for e in entries:
extra = e.get('extra')
env = e.get('environment')
rlist = e['requires']
for r in rlist:
if not env and not extra:
reqts.add(r)
else:
marker = ''
if extra:
marker = 'extra == "%s"' % extra
if env:
if marker:
marker = '(%s) and %s' % (env, marker)
else:
marker = env
reqts.add(';'.join((r, marker)))
return reqts
assert self._data and not self._legacy
result = LegacyMetadata()
nmd = self._data
# import pdb; pdb.set_trace()
for nk, ok in self.LEGACY_MAPPING.items():
if not isinstance(nk, tuple):
if nk in nmd:
result[ok] = nmd[nk]
else:
d = nmd
found = True
for k in nk:
try:
d = d[k]
except (KeyError, IndexError):
found = False
break
if found:
result[ok] = d
r1 = process_entries(self.run_requires + self.meta_requires)
r2 = process_entries(self.build_requires + self.dev_requires)
if self.extras:
result['Provides-Extra'] = sorted(self.extras)
result['Requires-Dist'] = sorted(r1)
result['Setup-Requires-Dist'] = sorted(r2)
# TODO: any other fields wanted
return result
def write(self, path=None, fileobj=None, legacy=False, skip_unknown=True):
if [path, fileobj].count(None) != 1:
raise ValueError('Exactly one of path and fileobj is needed')
self.validate()
if legacy:
if self._legacy:
legacy_md = self._legacy
else:
legacy_md = self._to_legacy()
if path:
legacy_md.write(path, skip_unknown=skip_unknown)
else:
legacy_md.write_file(fileobj, skip_unknown=skip_unknown)
else:
if self._legacy:
d = self._from_legacy()
else:
d = self._data
if fileobj:
json.dump(d, fileobj, ensure_ascii=True, indent=2, sort_keys=True)
else:
with codecs.open(path, 'w', 'utf-8') as f:
json.dump(d, f, ensure_ascii=True, indent=2, sort_keys=True)
def add_requirements(self, requirements):
if self._legacy:
self._legacy.add_requirements(requirements)
else:
run_requires = self._data.setdefault('run_requires', [])
always = None
for entry in run_requires:
if 'environment' not in entry and 'extra' not in entry:
always = entry
break
if always is None:
always = {'requires': requirements}
run_requires.insert(0, always)
else:
rset = set(always['requires']) | set(requirements)
always['requires'] = sorted(rset)
def __repr__(self):
name = self.name or '(no name)'
version = self.version or 'no version'
return '<%s %s %s (%s)>' % (self.__class__.__name__, self.metadata_version, name, version)
././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1781005788.0
distlib-0.4.3/distlib/resources.py 0000664 0001750 0001750 00000026364 15211776734 016316 0 ustar 00vinay vinay # -*- coding: utf-8 -*-
#
# Copyright (C) 2013-2026 Vinay Sajip.
# Licensed to the Python Software Foundation under a contributor agreement.
# See LICENSE.txt and CONTRIBUTORS.txt.
#
from __future__ import unicode_literals
import bisect
import io
import logging
import os
import pkgutil
import sys
import types
import zipimport
from . import DistlibException
from .util import cached_property, get_cache_base, Cache
logger = logging.getLogger(__name__)
cache = None # created when needed
class ResourceCache(Cache):
def __init__(self, base=None):
if base is None:
# Use native string to avoid issues on 2.x: see Python #20140.
base = os.path.join(get_cache_base(), str('resource-cache'))
super(ResourceCache, self).__init__(base)
def is_stale(self, resource, path):
"""
Is the cache stale for the given resource?
:param resource: The :class:`Resource` being cached.
:param path: The path of the resource in the cache.
:return: True if the cache is stale.
"""
# Cache invalidation is a hard problem :-)
return True
def get(self, resource):
"""
Get a resource into the cache,
:param resource: A :class:`Resource` instance.
:return: The pathname of the resource in the cache.
"""
prefix, path = resource.finder.get_cache_info(resource)
if prefix is None:
result = path
else:
result = os.path.join(self.base, self.prefix_to_dir(prefix), path)
dirname = os.path.dirname(result)
if not os.path.isdir(dirname):
os.makedirs(dirname)
if not os.path.exists(result):
stale = True
else:
stale = self.is_stale(resource, path)
if stale:
# write the bytes of the resource to the cache location
with open(result, 'wb') as f:
f.write(resource.bytes)
return result
class ResourceBase(object):
def __init__(self, finder, name):
self.finder = finder
self.name = name
class Resource(ResourceBase):
"""
A class representing an in-package resource, such as a data file. This is
not normally instantiated by user code, but rather by a
:class:`ResourceFinder` which manages the resource.
"""
is_container = False # Backwards compatibility
def as_stream(self):
"""
Get the resource as a stream.
This is not a property to make it obvious that it returns a new stream
each time.
"""
return self.finder.get_stream(self)
@cached_property
def file_path(self):
global cache
if cache is None:
cache = ResourceCache()
return cache.get(self)
@cached_property
def bytes(self):
return self.finder.get_bytes(self)
@cached_property
def size(self):
return self.finder.get_size(self)
class ResourceContainer(ResourceBase):
is_container = True # Backwards compatibility
@cached_property
def resources(self):
return self.finder.get_resources(self)
class ResourceFinder(object):
"""
Resource finder for file system resources.
"""
if sys.platform.startswith('java'):
skipped_extensions = ('.pyc', '.pyo', '.class')
else:
skipped_extensions = ('.pyc', '.pyo')
def __init__(self, module):
self.module = module
self.loader = getattr(module, '__loader__', None)
self.base = os.path.dirname(getattr(module, '__file__', ''))
def _adjust_path(self, path):
return os.path.realpath(path)
def _is_in_base(self, path):
base = self._adjust_path(self.base)
if path == base:
return True
if not base.endswith(os.sep):
base = base + os.sep
return path.startswith(base)
def _make_path(self, resource_name):
# Issue #50: need to preserve type of path on Python 2.x
# like os.path._get_sep
if isinstance(resource_name, bytes): # should only happen on 2.x
sep = b'/'
else:
sep = '/'
parts = resource_name.split(sep)
parts.insert(0, self.base)
result = os.path.join(*parts)
result = self._adjust_path(result)
# See issue 263: code below commented out as it proved to be
# too aggressively cautious, causing problems in valid use case scenarios.
# Confine the resolved resource to the package base so a resource
# name containing '..' cannot read files outside the package.
# if not self._is_in_base(result):
# raise DistlibException('Resource name escapes package: '
# '%r' % resource_name)
return result
def _find(self, path):
return os.path.exists(path)
def get_cache_info(self, resource):
return None, resource.path
def find(self, resource_name):
path = self._make_path(resource_name)
if not self._find(path):
result = None
else:
if self._is_directory(path):
result = ResourceContainer(self, resource_name)
else:
result = Resource(self, resource_name)
result.path = path
return result
def get_stream(self, resource):
return open(resource.path, 'rb')
def get_bytes(self, resource):
with open(resource.path, 'rb') as f:
return f.read()
def get_size(self, resource):
return os.path.getsize(resource.path)
def get_resources(self, resource):
def allowed(f):
return (f != '__pycache__' and not f.endswith(self.skipped_extensions))
return set([f for f in os.listdir(resource.path) if allowed(f)])
def is_container(self, resource):
return self._is_directory(resource.path)
_is_directory = staticmethod(os.path.isdir)
def iterator(self, resource_name):
resource = self.find(resource_name)
if resource is not None:
todo = [resource]
while todo:
resource = todo.pop(0)
yield resource
if resource.is_container:
rname = resource.name
for name in resource.resources:
if not rname:
new_name = name
else:
new_name = '/'.join([rname, name])
child = self.find(new_name)
if child.is_container:
todo.append(child)
else:
yield child
class ZipResourceFinder(ResourceFinder):
"""
Resource finder for resources in .zip files.
"""
def __init__(self, module):
super(ZipResourceFinder, self).__init__(module)
archive = self.loader.archive
self.prefix_len = 1 + len(archive)
# PyPy doesn't have a _files attr on zipimporter, and you can't set one
if hasattr(self.loader, '_files'):
self._files = self.loader._files
else:
self._files = zipimport._zip_directory_cache[archive]
self.index = sorted(self._files)
def _adjust_path(self, path):
return path
def _find(self, path):
path = path[self.prefix_len:]
if path in self._files:
result = True
else:
if path and path[-1] != os.sep:
path = path + os.sep
i = bisect.bisect(self.index, path)
try:
result = self.index[i].startswith(path)
except IndexError:
result = False
if not result:
logger.debug('_find failed: %r %r', path, self.loader.prefix)
else:
logger.debug('_find worked: %r %r', path, self.loader.prefix)
return result
def get_cache_info(self, resource):
prefix = self.loader.archive
path = resource.path[1 + len(prefix):]
return prefix, path
def get_bytes(self, resource):
return self.loader.get_data(resource.path)
def get_stream(self, resource):
return io.BytesIO(self.get_bytes(resource))
def get_size(self, resource):
path = resource.path[self.prefix_len:]
return self._files[path][3]
def get_resources(self, resource):
path = resource.path[self.prefix_len:]
if path and path[-1] != os.sep:
path += os.sep
plen = len(path)
result = set()
i = bisect.bisect(self.index, path)
while i < len(self.index):
if not self.index[i].startswith(path):
break
s = self.index[i][plen:]
result.add(s.split(os.sep, 1)[0]) # only immediate children
i += 1
return result
def _is_directory(self, path):
path = path[self.prefix_len:]
if path and path[-1] != os.sep:
path += os.sep
i = bisect.bisect(self.index, path)
try:
result = self.index[i].startswith(path)
except IndexError:
result = False
return result
_finder_registry = {type(None): ResourceFinder, zipimport.zipimporter: ZipResourceFinder}
try:
# In Python 3.6, _frozen_importlib -> _frozen_importlib_external
try:
import _frozen_importlib_external as _fi
except ImportError:
import _frozen_importlib as _fi
_finder_registry[_fi.SourceFileLoader] = ResourceFinder
_finder_registry[_fi.FileFinder] = ResourceFinder
# See issue #146
_finder_registry[_fi.SourcelessFileLoader] = ResourceFinder
del _fi
except (ImportError, AttributeError):
pass
def register_finder(loader, finder_maker):
_finder_registry[type(loader)] = finder_maker
_finder_cache = {}
def finder(package):
"""
Return a resource finder for a package.
:param package: The name of the package.
:return: A :class:`ResourceFinder` instance for the package.
"""
if package in _finder_cache:
result = _finder_cache[package]
else:
if package not in sys.modules:
__import__(package)
module = sys.modules[package]
path = getattr(module, '__path__', None)
if path is None:
raise DistlibException('You cannot get a finder for a module, '
'only for a package')
loader = getattr(module, '__loader__', None)
finder_maker = _finder_registry.get(type(loader))
if finder_maker is None:
raise DistlibException('Unable to locate finder for %r' % package)
result = finder_maker(module)
_finder_cache[package] = result
return result
_dummy_module = types.ModuleType(str('__dummy__'))
def finder_for_path(path):
"""
Return a resource finder for a path, which should represent a container.
:param path: The path.
:return: A :class:`ResourceFinder` instance for the path.
"""
result = None
# calls any path hooks, gets importer into cache
pkgutil.get_importer(path)
loader = sys.path_importer_cache.get(path)
finder = _finder_registry.get(type(loader))
if finder:
module = _dummy_module
module.__file__ = os.path.join(path, '')
module.__loader__ = loader
result = finder(module)
return result
././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1780397339.0
distlib-0.4.3/distlib/scripts.py 0000664 0001750 0001750 00000044623 15207532433 015760 0 ustar 00vinay vinay # -*- coding: utf-8 -*-
#
# Copyright (C) 2013-2026 Vinay Sajip.
# Licensed to the Python Software Foundation under a contributor agreement.
# See LICENSE.txt and CONTRIBUTORS.txt.
#
from io import BytesIO
import logging
import os
import re
import struct
import sys
import time
from zipfile import ZipInfo
from . import DistlibException
from .compat import sysconfig, detect_encoding, ZipFile
from .resources import finder
from .util import (FileOperator, get_export_entry, convert_path, get_executable, get_platform, in_venv,
is_in_directory)
logger = logging.getLogger(__name__)
_DEFAULT_MANIFEST = '''
'''.strip()
# check if Python is called on the first line with this expression
FIRST_LINE_RE = re.compile(b'^#!.*pythonw?[0-9.]*([ \t].*)?$')
SCRIPT_TEMPLATE = r'''# -*- coding: utf-8 -*-
import re
import sys
if __name__ == '__main__':
from %(module)s import %(import_name)s
sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
sys.exit(%(func)s())
'''
# Pre-fetch the contents of all executable wrapper stubs.
# This is to address https://github.com/pypa/pip/issues/12666.
# When updating pip, we rename the old pip in place before installing the
# new version. If we try to fetch a wrapper *after* that rename, the finder
# machinery will be confused as the package is no longer available at the
# location where it was imported from. So we load everything into memory in
# advance.
if os.name == 'nt' or (os.name == 'java' and os._name == 'nt'):
# Issue 31: don't hardcode an absolute package name, but
# determine it relative to the current package
DISTLIB_PACKAGE = __name__.rsplit('.', 1)[0]
WRAPPERS = {
r.name: r.bytes
for r in finder(DISTLIB_PACKAGE).iterator("")
if r.name.endswith(".exe")
}
def enquote_executable(executable):
if ' ' in executable:
# make sure we quote only the executable in case of env
# for example /usr/bin/env "/dir with spaces/bin/jython"
# instead of "/usr/bin/env /dir with spaces/bin/jython"
# otherwise whole
if executable.startswith('/usr/bin/env '):
env, _executable = executable.split(' ', 1)
if ' ' in _executable and not _executable.startswith('"'):
executable = '%s "%s"' % (env, _executable)
else:
if not executable.startswith('"'):
executable = '"%s"' % executable
return executable
# Keep the old name around (for now), as there is at least one project using it!
_enquote_executable = enquote_executable
class ScriptMaker(object):
"""
A class to copy or create scripts from source scripts or callable
specifications.
"""
script_template = SCRIPT_TEMPLATE
executable = None # for shebangs
def __init__(self, source_dir, target_dir, add_launchers=True, dry_run=False, fileop=None):
self.source_dir = source_dir
self.target_dir = target_dir
self.add_launchers = add_launchers
self.force = False
self.clobber = False
# It only makes sense to set mode bits on POSIX.
self.set_mode = (os.name == 'posix') or (os.name == 'java' and os._name == 'posix')
self.variants = set(('', 'X.Y'))
self._fileop = fileop or FileOperator(dry_run)
self._is_nt = os.name == 'nt' or (os.name == 'java' and os._name == 'nt')
self.version_info = sys.version_info
def _get_alternate_executable(self, executable, options):
if options.get('gui', False) and self._is_nt: # pragma: no cover
dn, fn = os.path.split(executable)
fn = fn.replace('python', 'pythonw')
executable = os.path.join(dn, fn)
return executable
if sys.platform.startswith('java'): # pragma: no cover
def _is_shell(self, executable):
"""
Determine if the specified executable is a script
(contains a #! line)
"""
try:
with open(executable) as fp:
return fp.read(2) == '#!'
except (OSError, IOError):
logger.warning('Failed to open %s', executable)
return False
def _fix_jython_executable(self, executable):
if self._is_shell(executable):
# Workaround for Jython is not needed on Linux systems.
import java
if java.lang.System.getProperty('os.name') == 'Linux':
return executable
elif executable.lower().endswith('jython.exe'):
# Use wrapper exe for Jython on Windows
return executable
return '/usr/bin/env %s' % executable
def _build_shebang(self, executable, post_interp):
"""
Build a shebang line. In the simple case (on Windows, or a shebang line
which is not too long or contains spaces) use a simple formulation for
the shebang. Otherwise, use /bin/sh as the executable, with a contrived
shebang which allows the script to run either under Python or sh, using
suitable quoting. Thanks to Harald Nordgren for his input.
See also: http://www.in-ulm.de/~mascheck/various/shebang/#length
https://hg.mozilla.org/mozilla-central/file/tip/mach
"""
if os.name != 'posix':
simple_shebang = True
elif getattr(sys, "cross_compiling", False):
# In a cross-compiling environment, the shebang will likely be a
# script; this *must* be invoked with the "safe" version of the
# shebang, or else using os.exec() to run the entry script will
# fail, raising "OSError 8 [Errno 8] Exec format error".
simple_shebang = False
else:
# Add 3 for '#!' prefix and newline suffix.
shebang_length = len(executable) + len(post_interp) + 3
if sys.platform == 'darwin':
max_shebang_length = 512
else:
max_shebang_length = 127
simple_shebang = ((b' ' not in executable) and (shebang_length <= max_shebang_length))
if simple_shebang:
result = b'#!' + executable + post_interp + b'\n'
else:
result = b'#!/bin/sh\n'
result += b"'''exec' " + executable + post_interp + b' "$0" "$@"\n'
result += b"' '''\n"
return result
def _get_shebang(self, encoding, post_interp=b'', options=None):
enquote = True
if self.executable:
executable = self.executable
enquote = False # assume this will be taken care of
elif not sysconfig.is_python_build():
executable = get_executable()
elif in_venv(): # pragma: no cover
executable = os.path.join(sysconfig.get_path('scripts'), 'python%s' % sysconfig.get_config_var('EXE'))
else: # pragma: no cover
if os.name == 'nt':
# for Python builds from source on Windows, no Python executables with
# a version suffix are created, so we use python.exe
executable = os.path.join(sysconfig.get_config_var('BINDIR'),
'python%s' % (sysconfig.get_config_var('EXE')))
else:
executable = os.path.join(
sysconfig.get_config_var('BINDIR'),
'python%s%s' % (sysconfig.get_config_var('VERSION'), sysconfig.get_config_var('EXE')))
if options:
executable = self._get_alternate_executable(executable, options)
if sys.platform.startswith('java'): # pragma: no cover
executable = self._fix_jython_executable(executable)
# Normalise case for Windows - COMMENTED OUT
# executable = os.path.normcase(executable)
# N.B. The normalising operation above has been commented out: See
# issue #124. Although paths in Windows are generally case-insensitive,
# they aren't always. For example, a path containing a ẞ (which is a
# LATIN CAPITAL LETTER SHARP S - U+1E9E) is normcased to ß (which is a
# LATIN SMALL LETTER SHARP S' - U+00DF). The two are not considered by
# Windows as equivalent in path names.
# If the user didn't specify an executable, it may be necessary to
# cater for executable paths with spaces (not uncommon on Windows)
if enquote:
executable = enquote_executable(executable)
# Issue #51: don't use fsencode, since we later try to
# check that the shebang is decodable using utf-8.
executable = executable.encode('utf-8')
# in case of IronPython, play safe and enable frames support
if (sys.platform == 'cli' and '-X:Frames' not in post_interp and
'-X:FullFrames' not in post_interp): # pragma: no cover
post_interp += b' -X:Frames'
shebang = self._build_shebang(executable, post_interp)
# Python parser starts to read a script using UTF-8 until
# it gets a #coding:xxx cookie. The shebang has to be the
# first line of a file, the #coding:xxx cookie cannot be
# written before. So the shebang has to be decodable from
# UTF-8.
try:
shebang.decode('utf-8')
except UnicodeDecodeError: # pragma: no cover
raise ValueError('The shebang (%r) is not decodable from utf-8' % shebang)
# If the script is encoded to a custom encoding (use a
# #coding:xxx cookie), the shebang has to be decodable from
# the script encoding too.
if encoding != 'utf-8':
try:
shebang.decode(encoding)
except UnicodeDecodeError: # pragma: no cover
raise ValueError('The shebang (%r) is not decodable '
'from the script encoding (%r)' % (shebang, encoding))
return shebang
def _get_script_text(self, entry):
return self.script_template % dict(
module=entry.prefix, import_name=entry.suffix.split('.')[0], func=entry.suffix)
manifest = _DEFAULT_MANIFEST
def get_manifest(self, exename):
base = os.path.basename(exename)
return self.manifest % base
def _write_script(self, names, shebang, script_bytes, filenames, ext):
use_launcher = self.add_launchers and self._is_nt
if not use_launcher:
script_bytes = shebang + script_bytes
else: # pragma: no cover
if ext == 'py':
launcher = self._get_launcher('t')
else:
launcher = self._get_launcher('w')
stream = BytesIO()
with ZipFile(stream, 'w') as zf:
source_date_epoch = os.environ.get('SOURCE_DATE_EPOCH')
if source_date_epoch:
date_time = time.gmtime(int(source_date_epoch))[:6]
zinfo = ZipInfo(filename='__main__.py', date_time=date_time)
zf.writestr(zinfo, script_bytes)
else:
zf.writestr('__main__.py', script_bytes)
zip_data = stream.getvalue()
script_bytes = launcher + shebang + zip_data
for name in names:
outname = os.path.abspath(os.path.join(self.target_dir, name))
if not is_in_directory(outname, self.target_dir):
raise DistlibException('Attempt to escape script directory')
if use_launcher: # pragma: no cover
n, e = os.path.splitext(outname)
if e.startswith('.py'):
outname = n
outname = '%s.exe' % outname
try:
self._fileop.write_binary_file(outname, script_bytes)
except Exception:
# Failed writing an executable - it might be in use.
logger.warning('Failed to write executable - trying to '
'use .deleteme logic')
dfname = '%s.deleteme' % outname
if os.path.exists(dfname):
os.remove(dfname) # Not allowed to fail here
os.rename(outname, dfname) # nor here
self._fileop.write_binary_file(outname, script_bytes)
logger.debug('Able to replace executable using '
'.deleteme logic')
try:
os.remove(dfname)
except Exception:
pass # still in use - ignore error
else:
if self._is_nt and not outname.endswith('.' + ext): # pragma: no cover
outname = '%s.%s' % (outname, ext)
if os.path.exists(outname) and not self.clobber:
logger.warning('Skipping existing file %s', outname)
continue
self._fileop.write_binary_file(outname, script_bytes)
if self.set_mode:
self._fileop.set_executable_mode([outname])
filenames.append(outname)
variant_separator = '-'
def get_script_filenames(self, name):
result = set()
if '' in self.variants:
result.add(name)
if 'X' in self.variants:
result.add('%s%s' % (name, self.version_info[0]))
if 'X.Y' in self.variants:
result.add('%s%s%s.%s' % (name, self.variant_separator, self.version_info[0], self.version_info[1]))
return result
def _make_script(self, entry, filenames, options=None):
post_interp = b''
if options:
args = options.get('interpreter_args', [])
if args:
args = ' %s' % ' '.join(args)
post_interp = args.encode('utf-8')
shebang = self._get_shebang('utf-8', post_interp, options=options)
script = self._get_script_text(entry).encode('utf-8')
scriptnames = self.get_script_filenames(entry.name)
if options and options.get('gui', False):
ext = 'pyw'
else:
ext = 'py'
self._write_script(scriptnames, shebang, script, filenames, ext)
def _copy_script(self, script, filenames):
adjust = False
script = os.path.join(self.source_dir, convert_path(script))
outname = os.path.join(self.target_dir, os.path.basename(script))
if not self.force and not self._fileop.newer(script, outname):
logger.debug('not copying %s (up-to-date)', script)
return
# Always open the file, but ignore failures in dry-run mode --
# that way, we'll get accurate feedback if we can read the
# script.
try:
f = open(script, 'rb')
except IOError: # pragma: no cover
if not self.dry_run:
raise
f = None
else:
first_line = f.readline()
if not first_line: # pragma: no cover
logger.warning('%s is an empty file (skipping)', script)
return
match = FIRST_LINE_RE.match(first_line.replace(b'\r\n', b'\n'))
if match:
adjust = True
post_interp = match.group(1) or b''
if not adjust:
if f:
f.close()
self._fileop.copy_file(script, outname)
if self.set_mode:
self._fileop.set_executable_mode([outname])
filenames.append(outname)
else:
logger.info('copying and adjusting %s -> %s', script, self.target_dir)
if not self._fileop.dry_run:
encoding, lines = detect_encoding(f.readline)
f.seek(0)
shebang = self._get_shebang(encoding, post_interp)
if b'pythonw' in first_line: # pragma: no cover
ext = 'pyw'
else:
ext = 'py'
n = os.path.basename(outname)
self._write_script([n], shebang, f.read(), filenames, ext)
if f:
f.close()
@property
def dry_run(self):
return self._fileop.dry_run
@dry_run.setter
def dry_run(self, value):
self._fileop.dry_run = value
if os.name == 'nt' or (os.name == 'java' and os._name == 'nt'): # pragma: no cover
# Executable launcher support.
# Launchers are from https://bitbucket.org/vinay.sajip/simple_launcher/
def _get_launcher(self, kind):
if struct.calcsize('P') == 8: # 64-bit
bits = '64'
else:
bits = '32'
platform_suffix = '-arm' if get_platform() == 'win-arm64' else ''
name = '%s%s%s.exe' % (kind, bits, platform_suffix)
if name not in WRAPPERS:
msg = ('Unable to find resource %s in package %s' %
(name, DISTLIB_PACKAGE))
raise ValueError(msg)
return WRAPPERS[name]
# Public API follows
def make(self, specification, options=None):
"""
Make a script.
:param specification: The specification, which is either a valid export
entry specification (to make a script from a
callable) or a filename (to make a script by
copying from a source location).
:param options: A dictionary of options controlling script generation.
:return: A list of all absolute pathnames written to.
"""
filenames = []
entry = get_export_entry(specification)
if entry is None:
self._copy_script(specification, filenames)
else:
self._make_script(entry, filenames, options=options)
return filenames
def make_multiple(self, specifications, options=None):
"""
Take a list of specifications and make scripts from them,
:param specifications: A list of specifications.
:return: A list of all absolute pathnames written to,
"""
filenames = []
for specification in specifications:
filenames.extend(self.make(specification, options))
return filenames
././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1659773740.0
distlib-0.4.3/distlib/t32.exe 0000600 0001750 0001750 00000277000 14273421454 015017 0 ustar 00vinay vinay MZ @ !L!This program cannot be run in DOS mode.
$ qv%%%[^;%%Ӎ%%Ӎ=%%Ӎ %%h0%%%%Ӎ
%%Ӎ9%%Ӎ>%%Rich% PE L
b
; @ 2 @ l < ` S @ \ .text `.rdata b, . @ @.data d7
@ .rsrc S ` T @ @.reloc ( n @ B U "A 3ʼnE} uEEPu h h P$ Ph<
A 9 @P j @ M3<
U "A 3ʼnE} uEEPu h h P^ Phx
A @P j @ M3 UMW3FP.A PQQ t.A ;uHE+D0ϋ_]U,VWh
A E3h;A P}}8
3;h
A Q jWuw$ u E$UE;}}WuuJ$ uh jS S9 ;t+EjY}E~ V+ EE YE;}}Wuu# uVju> u3;h
A uPUE+EjEYu}E7
,MMj )Muu }# u WjS 3;
A VPf
A $f;u]TEy3j Pu,# uWjS 3;VP$D f
A f;tH;sEu% EY_^U Vj.u3u YYt Vh=A h VuV@ ttFqWh A EPEP# uui ;uIEP A Wu Vh=A h PuV@ uEPWV ;u3Fu Y_^U}t }v)}w#h;A t%;A jphp;A j P @ 3@]UuL@ tuEujju@ ]3@]UQf}rotkUW8k;rWSVh @ t <^ YE};s++ttt P/% Y;]ru Y^[_UVWh @ y u YYx P YWU Y_^]UVW
P
Pu
@P Et;
; t; ; t; ; 5@@ SjjjE։E(
P*#
P # 5H@ YY;t9]u3SjE;t9Eu
j jփe E;t9Eu
j jփe E;u3;Eue ;Eue =X@ tt Sj j39]t}t
uSj9]t}t
uSj[_^Ud
"A 3ʼnEESVW3WW<@ 3;h A h;A QYYPjpp;A Vj 5h;A ,@ tpu3@3h, A P
;A 0 YYjpVj 5h;A @ hL A PjDWPc P4@ 5@@ jjjS$l A PKVh A P4h A P h=A PWWWjWWW@ ;u=D@ W QRQPWh @ Ph A W15=A 5h;A @ YPh 8@ H= w
PT@ jh@ P@ h, A P0YY5=A X@ Wj5=A @ P5=A $@ hL A PYY @ UQSVW=L@ p A Sut>FE ft "tjP YYu SuuӅt
] ]j h| A Sa 3ɅSh A Qg{ftjPB YYt3@3Sh A P8 ftjP YYuf? tjP YYuf9ujP YYt3fW`Sh
A j X=A Pf;"u&3f>"ShH
A P3f jh
A Sk t f{ "t3f>"Sh
A Pa ft&jP? YYt3fjP* YYt fuE 0_^[U0 "A 3ʼnESVW@ f8"tj j"YQP7 YYu Dž A $pjP YYt fu牵 W;A Vj (@ f=;A "t
Dž;A 3ɍf B.A P3h A PNY 3Y;s
t
tA;r3hA PYYWP +VSjh 0@ 33;hDA P3fuYYf9tjP YYtf9 u3f>#hpA PYYj_jP} YYt
f;u3f>!hA PhYYjPM YYt
f;u荅PVS3hA P%39h A Pj[SWh
A $uvh;A h P4 PP@ f "u+j[G j"P 3WhH
A P3f_PPPT@ ǍPffu+Hffu+Hffu+ȋPffu+jt1VD 3h<A PWhpA VVS2 0Sy;
"A u@ j hPA # 3}3];;uP# 3{3u ;;t3f9>;t! E;u
# ɉ}f9;u # jEPh"A $% PuVS EE EO# u^ YËUVuu" j^0
$h uu t3t" ^]ËUEfU f;tfuf9t3]j hpA " 3u3;;u'" |
K39} ;t߉uV5 Y}V% ؍EPWu Vr& EVS& E EU" ud YËU} t-uj 5$2A l@ uV! D@ PF! Y^]ËUQe VEPu u1 u9EtU! t
L! M^ËUEVF uc= FHlHhN;
h+A t
)A Hpu; F;((A tF
)A Hpu3 FF@puHpF
@F^] U3SW9E ]u } tVuM0Ex uA+;Ar
Zw Ar Zw MtDft?f;t8EPP? EPP? Mt
ftf;t+} ^tMap_[ËU=T2A Vuy39E uu cM t+Ar
Zw Ar Zw Mt
ftf;t+j uu u^]ËUS]woVW=$2A uC j GB h W? YYt3@Pj 5$2A p@ u&j ^98A t
SD Yu 0 0_^SC Y 3[]ø A á`WA Vj^u ;}ƣ`WA jPTF YYDGA u jV5`WA ;F YYDGA ujX^3ҹ A DGA "A |j^3ҹ A W FA t;tu1 Bp A |_3^H =2A tF 5DGA YËUVu A ;r"`"A w+QJ N Y
Vt@ ^]ËUE}PI E H Y]ËE Pt@ ]ËUE A ;r =`"A w` +PH Y]Ã Px@ ]ËUME }` QH Y]Ã Px@ ]̋D$ StRT$3ۊ\$ t
2trt2 urWߋ_t
2t@u[Ãr
3˿~3σ tJ2t#2t2t 2t_B[ÍB_[ÍB_[ÍB_[ËUEt8 uPaY]ËUQQ"A 3ʼnESV3W;u j^0O , uVJ YY;Er3fՋE @;u)f9 tAr Zw ff9u3 SSjV WPJ ȃM;u| * q 9Ms3f[ j"];~Cj3Xr7D = w
J ;t PY;t Mu
놋E QSjVWpdI tSuVl j*YSYƍe_^[M3)ËUuMUMEPu n} YYtMapËUj u u ]ËUEPj uuu uP
]ËUMS] VW}M]t} tu g 3_^[Ëut 39Ev!t Sj QR t39Ew}F }tFEE F tDFt= ;r;} W6uuQ )~>}+߃)}} ;]r\} t 3;v uu+ ;w;Ew[PuV YPMP t{tdE+)E$VXI YtR} t"MEFKME&E} tu j ugQ " N +3uN j hA 3u9ut/9ut*9uu-} tu Vu
Q I 3 uaYuuuuu uEE EuYËUuuu juZ]j hA 3ۉ]3};;u 39] ;t܉}WY]G @uoW Yttȃ FA x+A A$u)tt FA x+A @$t" w M9]u#W EPSu WP EWV E Ee utYËUQ f9Eu3ø f9EsE
-A A EPjEPj|@ u!EEM #ËUEuf ]Ë@]ËUE.A ]ËU( "A 3ʼnES]WtS[ Y jLj PN 0 ffffffEMDž0 IM M@ j @ P@ uu tSZ YM_3[ËUV5.A @ u@ .A ^]ËVj Vj V@ P@ ^ËU5.A @ t]uuuu u3PPPPPËUQEu~ 3Vu t
Mu uU 3 Wft.>u ftf;t fuf> t fuf9 Mt tat0rt#wt A3a
3ۃM M3AWf; y @ S t tRHtCt-
t! 9E E @ @ E E ljE } utE nTtZtEHt0 t uE G} u;eE 1} u% UE u t3 f} j _f9>tjVh@ g f9>tf>=uuf9>tjh@ VV u
Ajh@ V7 u "jh@ V u f> t3f9>t h uE SuPf t3 E.A MH M x8xx H_^[jhA 33}j- Y]3u;5`WA DGA 9t[ @ uH uAFwFP, Y DGA 4VvYYDGA @ t PVYYF둋}cj8p( Y
DGA ;tNh DGA P@ DGA u4YDGA Pt@ DGA <}_ ;tg __ _ OE Ë}j+ YËUE3;͐"A tA-rHwj
X]Ë͔"A ]DjY;#]A u#A Ã. u#A Ã ËUVMQY0^]hA@ d5 D$l$l$+SVW"A 1E3PeuEEEEd ËMd
Y__^[]Q̋US] Vs35"A WE E {t
N3 8N F3 8E@f MUS[ EMt_I [LDE Et Ex@GEu} t$t
N3 8N V3 :E_^[]E ɋM9csmu)=8GA t h8GA d tUjR8GA M U E 9X th"A WӋ E MH t
N3 8N V3 :rEH* 9S Oh"A WA SVWT$D$L$URPQQhC@ d5 "A 3ĉD$d% D$0XL$,3p t;T$4t;v.4v\ H { uh CRe Cde d _^[ËL$A t3D$H3Uhp pp> ]D$T$ UL$)q qq( ] UVWS33333[_^]Ëjd 33333USVWj RhD@ Q~ _^[]Ul$RQt$ ] UVuVPd YYt| ;u3@;u`3@.A F uNSW< 2A ? u S# YuFjFXFF
?~>^^N 3_@[3^]ËU} t'Vu F tV % f f & f Y^]ËU@ @tx tPud YY f;u]]ËUx "A 3ʼnEESVu 3W}u
9u* L8t
`p
;t3҉f;
j[
AfXw( A 3H A jZ;
$YQ@ 3 tJt6t%+t f*u,j X k
ɍDЉ= 1 f*u& k
ɍDЉ ItWhtFltw f>lu 6u f~4u d 3u f~2u@ d7 i. o% u x X
QDž | d/ S t~At+tY+t+ Dž @ Dž 0 0 u u u -A QPb YYtFF9| X + ++ 3F tBPƅ PP2a yf6 t:Ht3 t+Dž -A P ` Y p e gitqnt(o Dž ta U7_ c t ffDž @Dž
W ufgu]Dž Q9~ ~7] Vn Yt
Dž 5@ GPPSP5.A Ћ t uPS5$.A YYfguuPS5 .A YY;-u CSDž $si+ Dž' Dž lj0XfQfG M t@tGGG@t3҉@t|s ځ u3 } Dž 9~ u! t-RPWS^ 0؋9~N뽍+F t_tƀ80tT 0=u -A Dž
Kf8 tu+ @t+ tj-tj+tj YfDž ++ u$ j OYtPS8 YYt/u&j0OYt uk~aP WPK[ ~$(Y.%7 YY |3t* j OYtރ t Yft/k c t
`pM_^3[NÐH@ F@ G@ cG@ G@ G@ H@ I@ j h j @ 3Ʌ$2A ËUMtj3X;E ss 3]M VuF3wVj5$2A p@ u2=8A t V_ YuҋEt 3
Mt ^]- t"t
t Ht3ø ø ø ø ËVWh 3F WP' 3ȋ~~~ ~ $A F +ο @Ou @Nu_^ËU "A 3ʼnESWPv@ 3@;rƅ t0;w+@P
j R& Cuj v vPWPjj ] 3SvWPWPWv S}\ DSvWPWPh v SX\ $3EtL tL @;rR Dž3) ЍZ w
L Q
w L Q A;rƋM_3[jj hA ( )A Gpt l twhuj Y@j
Ye whu;5((A t6tV@ u $A tVY((A Gh5((A uV@ E 뎋uj
YËUS3SM (2A u (2A @ 8]tEMapE,(A D; FG;v}> uЋuE}urlj{C ijC C4(A Zf1f0JuL @;v~ 0C @IuCC Ss3ȋ {95(2A TM_^3[ajhA M }_huqE;CW h : YF wh# SuYYE uvh@ uFh= $A tPY^hS=@ Fp )A j
Ye C82A C<2A C @2A 3E}fLCf E,2A @3E= }
L &A @3E= } ('A @5((A @ u((A = $A tPY ((A SE 0j
Y%u $A tSY] e EÃ=,GA ujVY,GA 3ËUSV5@ W}W tP tP tP tP֍_PE {$)A t tPփ{ t
CtPփMu P_^[]ËUW} SV5@ W tP tP tP tP֍_PE {$)A t tPփ{ t
CtPփMu P^[_]ËUSVu 3W;to=8.A th ;t^9uZ ;t9uP Z YY ;t9uP ?Z YY YY ;tD9u@ - P +P +P u =()A t9 uPEV LYY~PE $)A t;t 9uP'Y9_tG;t 9uPYMuVY_^[]ËUW} t;Et4V0;t(W8jYtV> Yu*A tVsY^3_]j h8A )A Fpt"~l t pluj $ Yj Ye 5h+A lVYYYEE j Yuj @ @ V5p+A @ u5H2A @ V5p+A @ ^ál+A tP5P2A @ Ѓ
l+A p+A tP@
p+A jhXA hL@ @ uF\A f 3G~~pƆ CƆK CFh $A j
Ye vh@ E> j u Y}E Fluh+A FlvlYE a3Guj
^ Yj U YËVWD@ 5l+A ЋuNh jl YYt:V5l+A 5L2A @ Ѕtj VYY@ N VY3W@ _^ËVuj Y^jhA du F$tPGYF,tP9YF4tP+YF7 5(GA 5$GA 9]u9Et]܉]ЉE؋}ԋ]E@ }@ sE tЃEE@ }@ sE tЃEE } u)2A j Yu} tj YËUj j u ]ËUj ju ]jj j jjj z ËU u2 Yh ̋U3M; @ t
@r3]Ë@ ]ËU "A 3ʼnESVuWV3Y;l j\ Y j\ Yu
="A 6 h@ h 2A W h 2A VSf4A (@ u h@ SV t 3PPPPPV0 @Y^_[ËU} u ֽ]S]VuWuu9u u3 t} uD 4u uu;v*8CSVh@ uG 8"uY8PWVh@ D> u}u8"u% y u "
_^[]ËUuj uuu u]ËUE~ Pu YYu uPuu u@ ]ËU39E vMf9 t @;E r]QL$+ȃ Yg QL$+ȃ Yg UQVu VtE F Yu N / @t
" S3ۨt^ NF F F ^] u,ٱ ;t ͱ@;u
u 8 YuVh YF W F>HN+IN;~ WPu X EM F yM tt FA x+A @ tjSSQeg #t%FM3GWEPu oX E9}t N E% _[^ËUVuu ں F @ t F F u Vg YFvvV赸YPg F F uQV苸Yt0VYt$WVrV< FA b YY_x+A @$' } ~0E M P E>u?*u˰?P } Ճ? uE^ËU "A 3ʼnES] Vu3W}u¤u+ E t
`p7 F @u^VGYx+A ttȃ FA A$uttȃ FA @$q3;g
C39y
B @Dž
W @ 9} Dž jugucDž W9~ ~=] VYt
Dž 5@ GPPSP5.A Ћ t uPS5$.A YYguuPS5 .A YY;-u CSDž *snHHX Dž' Dž 2Qƅ0Dž t@tGGG@t3҉@t|sځ u39} Dž 9~ u!u t-RPWS) 0؋9~N뽍E+F tbt90tW0@?If90tu+(u -A I8 t@u+ @t5 t ƅ-t ƅ+ tƅ Dž ++ u% OF tP2YYt.u%˰0O7F tヽ tu~qPjEPPcV u69t.EP YYu#P]YY |2t) O^E t߃ t Ytr t
`pM_^3[Ð>~@ =|@ m|@ |@ }@ "}@ h}@ ~@ %EA ËUVuV蚩YuA MWuj u P @ uD@ 3t P1Y FA D0 _^]jhPA #]u Ź x; FA r蹹 螹 ҋ< FA D0tS"Ye D0tuu S ED L ME E謹Ë]SjYËUQC @VEt
{ uE C' } ~5E M P2E>Yu?*uj?Y} Ѓ? uE^ËUx "A 3ʼnES]Vu3Wu} ?u+0 腣 t
`p
3;tf;
jY9x
BfXw A 3k 0 A j^;O
$ @ 3 tHt4+t$+t f*u+f T k
ʍDЉ9 - f*u% k
ʍDЉ ItQht@ltw f?lu 6uf4u m 3uf2uO dF i= o4 u+ x" X RDž 賹Y d1 S tAt+tZ+t+ Dž @ Dž 0 0 u u [ u -A QP* YYtFF9| X + + 3F tBPƅ PPf yf6 t:Ht3 t+Dž -A PT Y p e gitnnt$o tb V[ x t ffDž @Dž
ދCS ufguWDž K;~ȁ ~7] VYt
Dž 5@ CPPWP5.A Ћ t uPW5$.A YYfguuPW5 .A YY?-u GWDž $s{+ Dž' Dž |j0XfQfW W t @tCC@Ct3҉@t|s ځ u3 } Dž 9~ u! t-RPWS$ 0؋9~N뽍+F t^tƀ80tS 0=Yxt"jWYYtAVWP脠 uI4~f> u5.A %.A # GA 3Y[_^5p2A %p2A 3PPPPP袔̋V@ 3;u3^f9tf9uf9uS+ƍXWSYu
V@ _[^SVW UVuF t tvcf 3YFF^]ËUE 8csmu*xu$@= t=!t="t= @u" 3] h @ @ 3ËUV2 N\UW9t
;r ;s9t3tPu3 u ` 3@ M S^`N`H j$Y~\d9 | ~d= u Fd ~= u Fd n= u Fd ^= u Fd N= u Fd >= u Fd .= u Fd = u Fd = uFd vdjY~d` QY^`[_^]Ã=,GA uV5.A W3u <=tGVz YtujGW
YY=h2A tˋ5.A S3VI >=YXt"jSYYt?VSPN uG> u5.A %.A ' GA 3Y[_^5h2A %h2A 3PPPPP裑̋UQMS3VU 9Et ]EE>"u39E"FE<tBU PF E Yt} t
M E FU Mt2} u t utB e > < t< uFN> } t EE3C3FA>\t>"u&u } t F8"u
339EEtIt\BuU tU} u< tK< tGt=Pt#8D Yt
M E FM E
D YtFU FVt BU ME^[t ËU S3VW9 ,GA u蘼h :A VS ;A @ WW6x E j[+PD=P6j% ;݃ FA D$2M0 FA D$M
ʀ} u!Etȃ FA D M #;u~EtxuX@ j uEjPuE%Pu $@ ;u4D@ Pȃ FA D 6脊Y6 FA EUSSSSS蛆jhpA ɛ3}3u;;uhj^0辆Y39};t9} tE%@tʉ}uuu uEP\EE E;t芛3u9}t(9}t FA D 6 YËUjuuuuu !]ËU} u3]ËU MMtft
f;u
+]̋UMMZ f9t3]ËA<8PE u3ҹ f9H]̋UEH<ASVq3WDt} H ;r X;r
B(;r3_^[]̋UjhA hA@ d PSVW"A 1E3PEd eE h @ *tTE- @ Ph @ Pt:@$ ЃEMd
Y_^[]ËE3ҁ9 ËeE3Md
Y_^[]USVWUj j h(@ u> ]_^[]ËL$A t2D$H3TuUhP(RP$R ]D$T$ SVWD$UPjh0@ d5 "A 3PD$d D$(Xp t:|$,t;t$,v-4v L$ H | uh DI D_ 뷋L$d
_^[3d
y0@ uQ R 9Qu SQ-A SQ-A L$ KCk UQPXY]Y[ ËUEuΗ 3]Åx; FA r賗 ދȃ FA D@]ËU"A 3ʼnESVu F @W6 VYx+A t.VڀYt"VV< FA 辀 YYÊ@$$< V蝀Yt.V葀Yt"V腀V< FA u YYÊ@$$< VTYt.VHYt"V<V< FA , YY@t]uEjPEPX1 t ]39}~0NxL=AD=VPJYYtG;}|fE Fx
Ef
EVP7 YYM_^3[rËVW3 .A @ .A (r_^á"A 39$;A ̋L$ t$tN u $ $ ~Ѓ3 tAt2t$ t t͍AL$+ÍAL$+ÍAL$+ÍAL$+ËUSVu 3;t9]t8 uE;t3f3^[uMsE9Xu E;tf8]tE`p3@ˍEPP YYt}E ~%9M| 39]RuQVj p0@ EuM; r 8^t 8]fMapZg * 8]tE`p;39]PuEjVj p0@ :뺋Uj uu u]ËUu MrEM A% } tMapËUj uYY]VD$ u(L$D$ 3؋D$d$ȋd$Gȋ\$T$ D$ ud$ȋD$r;T$ wr;D$v N+D$T$3+D$T$ ʋӋًȋ^ U"A 3ʼnEUS3VW;~ EI8t@;u+H;}@E]9]$u E @E$50@ 39](SSuu Pu$};u3R ~Cj3Xr7D?= wZ;t P5sY;t E]9]tWuuuju$օ 5@ SSWuuu ։E; Mt)E ; 9E Pu Wuuu };~Bj3Xr6D?;w;th PxrY;t 3;t?uWuuuu օt"SS9] uSSu u uWSu$@ EW uYuuEYe_^[M3mËUuMou(Eu$u u uuuu P$} tMapËUQQ"A 3ʼnES3VW]9] u E @E 50@ 39] SSuu Pu ;u3~<w4D?= w^;t P9qY;t t?Pj S
WSuuju օtuPSu |@ ESsEYe_^[M3lËUuMnu$Eu uuuu P } tMapËUVuc vmvmv mvmvmvm6mv mv$mv(mv,mv0mv4mv mv8mvl 3l (l l l l k k k k k k k k k k@ k k uk jk _k Tk$ Ik( >k, 3k0 (k4 k8 k< k@ jD jH j@L jP jT jX j\ j` j^]ËUVutY;8.A tP~jYF;<.A tPljYF;@.A tPZjYF0;h.A tPHjYv4;5l.A tV6jY^]ËUVu F ;D.A tPjYF;H.A tPiYF;L.A tPiYF;P.A tPiYF ;T.A tPiYF ;X.A tPiYF$;\.A tPiYF8;p.A tPiYF<;t.A tPiYF@;x.A tPniYFD;|.A tP\iYFH;.A tPJiYvL;5.A tV8iY^]UV3PPPPPPPPU I
t $uI
t $s ^ËUUVWt} u臊j^0u3Eu+ @tOuu Qj"Y3_^]̋T$L$ u<:u.
t&:au%
t :Au
t:au
uҋ3Ð t:u
t tf:u
t:au
tUWVu M};v; r =EA tWV;^_uy, ur)$@ Ǻ r $@ $ @ $@ @ @@ d@ #ъFGFGr$@ I #ъFGr$@ #ъr$@ I @ Ը@ ̸@ ĸ@ @ @ @ @ DDDDDDDDDDDDDD $@ @ @ @ (@ E^_ÐE^_ÐFGE^_ÍI FGFGE^_Ðt1|9 u$r
$@ $<@ I Ǻ r +$@ $@ @ Ĺ@ @ F#шGr$@ I F#шGFGr$@ F#шGFGFGV$@ I @@ H@ P@ X@ `@ h@ p@ @ D D DDDDDDD D DDDD $@ @ @ @ Ⱥ@ E^_ÐFGE^_ÍI FGFGE^_ÐFGFGFGE^_UV3PPPPPPPPU I
t $u
t $sF ^jhA 4襢@xte 3@ËeE) Mh0@ @ 0;A ËUE4;A 8;A <;A @;A ]ËUE
L A V9Ptk u ;rk M^;s9Pt3]5<;A @ j hA 舅3}}؋] KtjY+t"+t+tY+uCY}uT 4;A 4;A Uw\]YpQÃt2t!HtЄ %p빾<;A <;A 8;A 8;A
@;A @;A E P@ E3} 9Euj49EtP߰Y3Et
tuO`MԉG`u>OdMGd u,
@ A M܋
D A
@ A 9M}Mk W\DEE u wdSUY]}} tj pYSUYt
tuEԉG`uEЉGd37ËUEH;A ]ËUEL;A ]ËUQSV5@ W5(GA 5$GA ؉]; +GruS' ؍GY;sH ;s;rPuOYYuC;r>Pu9YYt/P4@ (GA u=@ Vף$GA E3_^[ËVjj 襪YYV@ (GA $GA ujX^Ã& 3^j hA e uYEE EעËUuYH]̋U$"A 3ʼnEESEE VWE7e =P;A Eu}h A (@ =@ h A Sׅ 5@ Ph A SP;A Ph A ST;A Phh A SX;A P֣`;A thP A SP֣\;A \;A M5@ ;tG9
`;A t?P5`;A t,t(ׅtMQj MQjPӅtEu M 3T;A ;Et)Pօt"ЉEtX;A ;EtPօtuЉE5P;A օtuuuu3M_^3[a]ËUVuWt} uȀj^0 l_^]ËMu3ff: tOut+f
ftOu3ufvj"Y몋UUS]VWuu9U u3_^[]Åt} u;j^0k݅u3fЋMu3fԋu+fft'Ou"+ fftOtKuu3fy3uM jPfDJXdfj"YjUMx ~ u.A ]á.A
.A ]q j]ËU} u u `Y]Vu u
u]Y3MW0uFVuj 5$2A ,@ u^98A t@V3Yt vV#Y~ 3_^]~D@ P~Y~D@ Py~YʋUM S3;vj3X;Es~ 3AMVW9]t u" YVuYYt;s+Vj S _^[]ËU "A 3ʼnEE VuW34809}u3 ;u ~8} Ji S FA L8$$?tu'Mu } } h D8 tjj j Vw VY D @l39H P44@ 3;` ;t 8?P 0@ 4 3,9E# @?g $3
ǃx8 tP4UM`8 jEPKPYt:4+M3@; jDSPQ C@jSDP- n 3PPjMQjDQP C@@ = j ,PVEP$ 4@
@089, j ,PjEP$ E
4@ , 08 <t<u!33Ƀ
@D <t<uRD Yf;DI 8 t)j
XPD Yf;D 80E9@ 8T4D8 3ɋD8 ? D 49M 3+4H;Ms&CA
u 0
@F@F rՋH+j (PVHP$ 4@ C (8;; +4;El% ? 49MH @ +4jH^;MsCΉ
u0j
[f @@fƁ@ rH+j (PVHP$ 4@ i (8;a +4;EGK 4,9Mu ,@ +4jH^;Ms;,,
uj
[f@@fƁ@ r3VVhU
QH++PPVh @ ; j (P+P5P$ 4@ t (; D@ D;\,+48;E ?Q(Qu448@ t(D 8 D@ D8 ulD t-j^9Duw w0?DwY1$ D@t48u3$ww w 8+0[M_3^SjhA w]uCw (w x; FA r w w Vbҋ< FA D0tSfYe D0tuu Sn Ev v ME EwË]SfYjh0A v]u\v x; FA r=v aڋ< FA DtSeYe Dt1SDeYP8@ u D@ Ee } tuMu ME E6vË]SeYA @ty t$Ix QP{YYu ËU "A 3ʼnES] Vu3W}uStu+t C` t
`pa F @u^VE^Yx+A ttȃ FA A$uttȃ FA @$q3;g
C9
B @Dž
GW @ } Dž jugucDž W9~ ~=] VYt
Dž 5@ GPPSP5.A Ћ t uPS5$.A YYguuPS5 .A YY;-u CS*stHH[ Dž' Dž 5Qƅ0Dž t@tGGG@t3҉@t|s ځ u3 } Dž 9~ u!u t-RPWS0؋9~N뽍E+F tct90tX0@@If8 tu+(u -A I8 t@u+ @t5 t ƅ-t ƅ+ tƅ Dž ++ u% OztPYYt.u%˰0O tヽ tu~qPjEPPI u69t.EPq YYu#PCYY |2t) ODt߃ tH Yt3d t
t
`pM_^3[EÍI Z@ W@ @ @ 1@ =@ @ @ QL$+#ȋ% ;r
Y $- UQQE VuEEWVE,XY;uh NjJuMQuP @ E;uD@ t PhYϋ FA D0 EU_^jhPA h]܉]Eu hh Mh Ë x; FA r@h %h zSы< FA L1tPWYe D0t uuu uE܉Ug g ]܉]E E܋U&huWYËU.A h YMAt
I A I AAA Aa ]fQSut7$ ffAfA fA0fA@fAPfA`fAp HuЅt7tI fIHut 3tIJutAHu[XËۃ+3RӃtAJutIKuZUj
<@ EA 3ËUSVu 3W};u;v
E;t3{E;tv;fj^0QVuMDE9X fE f;v6;t;v WSV豞 e * e 8]tMap_^[;t&;w ej"^0Q8]tE`pyE;t 8]HN++ˉN~ WPu D EN F =M tt FA x+A @ tSj j Q#t-F]f jEPu ]f] E9}t N % _[^jYWƃ уte fofoNfoV fo^0ffOfW f_0fof@fonPfov`fo~pfg@foPfw`fp JutIt fofvJut$t
vIuȃt FGIuX^_]ú ++Qȃt FGIut
vHuY tjY.A tjh @j}E jq~̋U} u[ F]uj 5$2A \@ ]ËUQ=.A u .A u j MQjMQPD@ tfEËUS39]u3AVWupjV9 ;t uVWQ u SSSSSE3_^[]UWVSM tMu} AZ I &
t'
t#:r:w:r:w:u u3:t rً[^_3PPjPjh @h,
A $@ .A á.A t tPX@ ̋D$L$ ȋL$ u D$ S؋D$d$؋D$[ %@ $ 2 L ^ v , < P ` p F 4 $
$ 0 H ` r 0 B X d r ~ , B T ` r
: J ` z R "@ X@ S@ @ _@ @ :#@
b M .A P/A c c s U T F - 8 U T F - 1 6 L E U N I C O D E H H : m m : s s d d d d , M M M M d d , y y y y M M / d d / y y P M A M D e c e m b e r N o v e m b e r O c t o b e r S e p t e m b e r A u g u s t J u l y J u n e A p r i l M a r c h F e b r u a r y J a n u a r y D e c N o v O c t S e p A u g J u l J u n M a y A p r M a r F e b J a n S a t u r d a y F r i d a y T h u r s d a y W e d n e s d a y T u e s d a y M o n d a y S u n d a y S a t F r i T h u W e d T u e M o n S u n HH:mm:ss dddd, MMMM dd, yyyy MM/dd/yy PM AM December November October September August July June April March February January Dec Nov Oct Sep Aug Jul Jun May Apr Mar Feb Jan Saturday Friday Thursday Wednesday Tuesday Monday Sunday Sat Fri Thu Wed Tue Mon Sun K E R N E L 3 2 . D L L FlsFree FlsSetValue FlsGetValue FlsAlloc
!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~ CorExitProcess m s c o r e e . d l l r u n t i m e e r r o r
T L O S S e r r o r
S I N G e r r o r
D O M A I N e r r o r
R 6 0 3 3
- A t t e m p t t o u s e M S I L c o d e f r o m t h i s a s s e m b l y d u r i n g n a t i v e c o d e i n i t i a l i z a t i o n
T h i s i n d i c a t e s a b u g i n y o u r a p p l i c a t i o n . I t i s m o s t l i k e l y t h e r e s u l t o f c a l l i n g a n M S I L - c o m p i l e d ( / c l r ) f u n c t i o n f r o m a n a t i v e c o n s t r u c t o r o r f r o m D l l M a i n .
R 6 0 3 2
- n o t e n o u g h s p a c e f o r l o c a l e i n f o r m a t i o n
R 6 0 3 1
- A t t e m p t t o i n i t i a l i z e t h e C R T m o r e t h a n o n c e .
T h i s i n d i c a t e s a b u g i n y o u r a p p l i c a t i o n .
R 6 0 3 0
- C R T n o t i n i t i a l i z e d
R 6 0 2 8
- u n a b l e t o i n i t i a l i z e h e a p
R 6 0 2 7
- n o t e n o u g h s p a c e f o r l o w i o i n i t i a l i z a t i o n
R 6 0 2 6
- n o t e n o u g h s p a c e f o r s t d i o i n i t i a l i z a t i o n
R 6 0 2 5
- p u r e v i r t u a l f u n c t i o n c a l l
R 6 0 2 4
- n o t e n o u g h s p a c e f o r _ o n e x i t / a t e x i t t a b l e
R 6 0 1 9
- u n a b l e t o o p e n c o n s o l e d e v i c e
R 6 0 1 8
- u n e x p e c t e d h e a p e r r o r
R 6 0 1 7
- u n e x p e c t e d m u l t i t h r e a d l o c k e r r o r
R 6 0 1 6
- n o t e n o u g h s p a c e f o r t h r e a d d a t a
R 6 0 1 0
- a b o r t ( ) h a s b e e n c a l l e d
R 6 0 0 9
- n o t e n o u g h s p a c e f o r e n v i r o n m e n t
R 6 0 0 8
- n o t e n o u g h s p a c e f o r a r g u m e n t s
R 6 0 0 2
- f l o a t i n g p o i n t s u p p o r t n o t l o a d e d
`@ @ @
h@ @ @ h@ @ @ P@ @ p@ @ @ @ @ ! @ x @ y @ z h@ `@ @@ M i c r o s o f t V i s u a l C + + R u n t i m e L i b r a r y
. . . < p r o g r a m n a m e u n k n o w n > R u n t i m e E r r o r !
P r o g r a m : ( n u l l ) (null) EEE50 P ( 8PX 700WP `h```` xpxxxx ( ( ( ( ( H h ( ( ( ( H H
!"#$%&'()*+,-./0123456789:;<=>?@abcdefghijklmnopqrstuvwxyz[\]^_`abcdefghijklmnopqrstuvwxyz{|}~
!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`ABCDEFGHIJKLMNOPQRSTUVWXYZ{|}~ GetProcessWindowStation GetUserObjectInformationW GetLastActivePopup GetActiveWindow MessageBoxW U S E R 3 2 . D L L EEE 00P ('8PW 700PP ( `h`hhhxppwpp C O N O U T $ F a t a l e r r o r i n l a u n c h e r : % s
Fatal error in launcher: %s
r b Failed to open executable Unable to find an appended archive. Unable to read from file #! P A T H E X T ; Job creation failed Job information querying failed Job information setting failed making stdin inheritable failed making stdout inheritable failed making stderr inheritable failed U n a b l e t o c r e a t e p r o c e s s u s i n g ' % l s ' : % l s control handler setting failed Failed to get exit code of process . e x e / u s r / b i n / e n v Expected to find a command ending in '.exe' in shebang line: %ls Expected to find whitespace after '/usr/bin/env': %ls Unable to find executable in environment: %ls Expected terminating double-quote for executable in shebang line: %ls < l a u n c h e r _ d i r > \ Terminating quote without starting quote for executable in shebang line: %ls Failed to find shebang Expected to find terminator in shebang line Expected to decode shebang line using UTF-8 Expected to find '#' at start of shebang line Expected to find '!' following '#' in shebang line Expected to find executable in shebang line Expected to find arguments (even if empty) in shebang line Expected to be able to allocate command line memory " % l s " % l s " % l s " % l s H "A 0A RSDS#YDkE@W C:\Users\Vinay\Projects\simple_launcher\dist\t32.pdb A C 0 g @ a @ ()@ Q*@ d/@ o1@ 43@ p2@ ?6@ 7@ 8@ T:@ ;@ ;@ @@ T@ X@ *\@ U]@ d]@ _@ #_@ c@ j@
l@ k@ m@ Ty@
@ ,@ ۧ@ @ P@ T@ =@ @ @ @ @ L $ 2 L ^ v , < P ` p F 4 $
$ 0 H ` r 0 B X d r ~ , B T ` r
: J ` z R ExitProcess GetCommandLineW SearchPathW qSetInformationJobObject CreateProcessW pSetHandleInformation WaitForSingleObjectEx AssignProcessToJobObject ^FormatMessageW GetExitCodeProcess GetModuleFileNameW QueryInformationJobObject gMultiByteToWideChar cGetStartupInfoW GetTempPathW CreateJobObjectA dGetStdHandle GetLastError SetStdHandle GetFileType -SetConsoleCtrlHandler MSetCurrentDirectoryW R CloseHandle KERNEL32.dll PathRemoveFileSpecW EStrStrIW : PathCombineW SHLWAPI.dll HeapFree HeapAlloc EnterCriticalSection 9LeaveCriticalSection iGetStringTypeW UnhandledExceptionFilter SetUnhandledExceptionFilter IsDebuggerPresent EncodePointer DecodePointer TerminateProcess GetCurrentProcess InitializeCriticalSectionAndSpinCount GetCommandLineA HeapSetInformation RtlUnwind HeapCreate rGetCPInfo InterlockedIncrement InterlockedDecrement hGetACP 7GetOEMCP
IsValidCodePage TlsAlloc TlsGetValue TlsSetValue TlsFree GetModuleHandleW sSetLastError GetCurrentThreadId EGetProcAddress %WriteFile oSetHandleCount DeleteCriticalSection Sleep -LCMapStringW ReadFile fSetFilePointer aFreeEnvironmentStringsW GetEnvironmentStringsW GetModuleFileNameA WideCharToMultiByte QueryPerformanceCounter GetTickCount GetCurrentProcessId yGetSystemTimeAsFileTime CreateFileW ?LoadLibraryW HeapReAlloc GetConsoleCP GetConsoleMode WFlushFileBuffers IsProcessorFeaturePresent d CompareStringW WSetEnvironmentVariableW SSetEndOfFile JGetProcessHeap HeapSize $WriteConsoleW `GA `GA N@D
!
5 A
C P R
S
W Y l
m p r
)
abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNOPQRSTUVWXYZ $A `y! @~ ڣ @ ڣ A Ϣ [ @~ Q Q^ _j2 1~ C H@ D@ @@ <@ 8@ 4@ 0@ (@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ t@ l@ `@ T@ P@ L@ @@ ,@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ l@ d@ \@ T@ L@ D@ <@ 4@ ,@ $@ @ @ @ @ @ @ @ D@ @ @ @ @ @ p@ \@ T@ L@ 8@ @ @ $)A $)A $)A $)A $)A 8.A A 0A A ()A *A A
@ A 0 A A A 4@ 4@ 4@ 4@ 4@ 4@ 4@ 4@ 4@ 4@ . . 0.A (;A (;A (;A (;A (;A (;A (;A (;A (;A 4.A ,;A ,;A ,;A ,;A ,;A ,;A ,;A 8.A . K 0 x 8 P e h f 0 @ Pb 8e ( `f o h pt % h ( h Z ( @ ... GGG WWW iii uuu ̀ ww ww|| ww wwww ww fwwwww|fwwwwwwffwwwwwwffwwwwwfflwwffffffwfffffflwffffffwffffff|ff ffff ff R\Ilffl )ff ح 2L 18 Ϥ" A< ΣTπ U ? ? ? ? ? ? ? ( 444 MMM SSS zzz p p {p{f fko f_fffk_fff[f}UUUfL4UUU_kJqO_~'[U_ U wwwww{ ~ ( @ %%% +++ 000 === AAA III MMM QQQ VVV YYY ]]] ~dF ggg jjj mmm rrr uuu }}} u? z= ~; gE kC oA r@ : I b p ƏK Уk ( , 1 ? 5 < \ C K Q s U [ c b ð / P p
=1 [Q yq / "P 0p = L Y g x 1 Q q &/ @P Zp t 1 Q q /& PA p[ t ϩ 1 Q q / P" p0 > M [ i y 1 Q q ұ / P p
>1 \Q zq / P p ! + 6 @ I Z 1p Q q / P 6 p L b x 1 Q q , / K P i p 1 Q q / - P ? p R c v 1 Q q ϑ ܱ / P p ! & , > X1 qQ q _______ CCBABAD L*(%$""&G ABJIIDDJC??AD_-(''%$GG#_ DIJIIJIIIDIJDD_+)(''%GG _ JMCEJ?ABAECA?BA_,+)('%%"!_ IM@AJACDCIDI____.,++>________ JMJJJJJJJJJF_..,+)('%$"! #G IMCEJJJI?J_ _...,+(('%$"! &_ JM?AJJJJCJ__...,+)(''%$" _ IMJJJJJJJJ_K=...,++(''%$! _ JMCDJJJJAJ_ K_______L*%$"!_ I_?AMNJJEJ_ L'%$"_ I_MMMMMMJJ_ _('%%_ I_CEMIJJMEM _(''*_ I_?BMDJEMDMF _)(-L I_MMMCMMMMM_________< ____ I_CEM1;MACDMEJM__ I_?A_D1@IJJMJMM_FF_ I__6_@/EMMMNMM_ FF _ I_C80EJDMJCJF F ?:AA20?_M_MIEM______M IC4BC/
N______MMMMJIDA I_9/ HJJMMJMMMJ??BA I_A7503 IJMMCBCBA44CC I___BAO;6___C_MJIDIDM I_CI___O;
@__C_C?J?AJ I_?A_DJJI@ O_CM?;I?J I_________H9MAIJJIJ I_CD_____JJI73C;IJIJ I_?AMDJJDIMJIE5:JIJ I__________MMIA:IJ JJJJJJJJJJJJJJJMJ ? ? ?( 444 MMM RRR YYY ~eG uuu }}} x> iE rC E ~ 7 ? H V b x /! P7 pL c y Ϗ 1 Q q / P p" , 6 @ J [ 1q Q q / P p
=1 [Q yq / "P 0p = L Y g x 1 Q q &/ @P Zp t 1 Q q /& PA p[ t ϩ 1 Q q / P" p0 > M [ i y 1 Q q ұ / P p
>1 \Q zq / P p ! + 6 @ I Z 1p Q q / P 6 p L b x 1 Q q , / K P i p 1 Q q / - P ? p R c v 1 Q q ϑ ܱ / P p ! & , > X1 qQ q ! %///* !* / "(%%'%/)
/ !#''/// /+/+ "*(/
/
!%(/
(
(*/ (///)
*/
)*
/ "///// /+ /// #
+ !% //
+ "*+ '#+//+' !%*++$++!+! !!! < ( 0 ` ! ! $ & & "
WܱNj+<<:5pi$ !!!4 888&SNJFB=950,( %%%5ǎVRNIE ѹ|Jq?o@ZUQMID@<73/+&"- Ɍ444"ք̴wq?]YUPLHC?;72.*%! """4 888&dya\XTPKGC>:61-)% O Ñ%%%5ʎA{;ys`\WSOJFB>951,($( 9|:z;xq?o@mAkBiCgCdDuZ;73.* Ǒ%%%5̎È>89}:{;yq?o@mAjBhCfD~dEuZ?:625 Оa789}:{;yr>p?n@lAjBhCfD}dEB>:5^ ό555"܄ѳ7789}:{;xr?p@n@lAjBgCeDFA=9 """4 ;;;&ŌC89~9|:z;xr?p@mAkAiBgCIEL ɑQQQJnnn~~~Įq?o@mAkBiC HHH"""vvv9~:{;yq?o@mAkB :::'''___sssttt8Ϧuǣvyp?n@lA 888T ---6fffnddd%%%"""OOOSSSċDҧuʤv{;yr?p?xM <<r?̷ 999VVV###)))444ѳ͝b@~9|:z;}Cg˶Ӎ ZZZlll;;;!!!""")))___&&&2 :::ppp{{{___WWWWWW:::!!!"""***www"""4 888& , ̑999ԖJJJ|||lll:::"""BBBXXX|||$$$6 , uuuKKKCCC@@@...www * Ҍ666"KKKaaaLLLWWW@ $ """4 ;;;&nnnfff!!!$$$999444]ttt|ȇ ɑ&&&5ЎvvvmmmVVV{{{OOOڥ aaaCCCppp ό555"ބ|||MMMfff """4 ;;;&\\\ Ǒ%%%5Ύݧ ܦ ͌555"ۄۥ """4 :::&ڤ Ñ%%%5ˎܤ ׇ
ww ?ww ??ww ?ww ?ww ?ww ?ww ?ww ?ww ?ww ?ww ?ww ?ww ww ww ww ww ww ww ww ww ww ww ww ww ww ?ww ?ww ?ww ?ww ?ww ?ww ?ww ?ww ?ww ?ww ?ww ww ww ww ww ww ww ww ?ww ww ww ww( @ !!!0\\\JeeeQ666D555A 0 $
vH<602\ 7qڴvvvj&&&D 1 "gLF@;5? кVQKE?9( aV[UPJD>82- uuun{{{j`ZTO Vo@lAb_YSMGB<60+%< aVmt>q?n@bb^XRLFA;5/)$Y wwwn}}}j~Cv=s>p?bba]WQKE@:4.(+ {;xbba[VPJD?93-' aV~:{;xr?o@lAiBfD}dE|cE|cEiB<61 ?9}:z;w=t>q?n@kAiCfD}cE|cE}dFGA;= aVңi89|:yq?n@kBhCeD|cE|cELF@m zzznjʓP8~9{;yp?mAjBgCeD|cEPJ\ ¯mAjBgC~dE aV}:z;xq?n@lAiC JJJőPyq?n@~Y VVV???wwwiiiΡkA|;y>>3@@@y~~~obbb000kkk@@@ ---U<<<&&&[[[ 6 uuusssWWWIII$$$&&&qqqlllg|||s 4 bbbhhhƑUUU000QQQ}}}---{bbb ( iiiLLLBBB aVggg+++NNN |||nj]]]tttkkk rrrwwwӦ aVӦ zzznjӦ ˉ ? ? ? ? ?( C o I ਨS=? _QF4 aZмoEcaXMB70~Iq?c`VK@58z;u=qv>3Eyn@iB~dE}dFGHYYYuuuġ=xmAhC}dE}eGS444|||gC}cEMMM~>q?kAiG RRR¢Gu=xKʺ ~AA A A A A A A A A A A A A A A ( h 00 % h 4 V S _ V E R S I O N _ I N F O ? f S t r i n g F i l e I n f o B 0 8 0 9 0 4 b 0 J C o m p a n y N a m e S i m p l e L a u n c h e r U s e r ^ F i l e D e s c r i p t i o n S i m p l e L a u n c h e r E x e c u t a b l e 2 F i l e V e r s i o n 1 . 1 . 0 . 1 4 0 I n t e r n a l N a m e t 3 2 . e x e j # L e g a l C o p y r i g h t C o p y r i g h t ( C ) S i m p l e L a u n c h e r U s e r 8 O r i g i n a l F i l e n a m e t 3 2 . e x e @ P r o d u c t N a m e S i m p l e L a u n c h e r 6 P r o d u c t V e r s i o n 1 . 1 . 0 . 1 4 D V a r F i l e I n f o $ T r a n s l a t i o n
PAPADDINGXXPAD
0A0Z0t00000 1)1A12h2y22 3 3)3S3_3o3333333/44=5q55!6<6H6M6c6l6r666666667,7B7r77777777 8 8%8+808>8D8M8S8`8f8k888888(999999X:f:::::::;I;m;};;;;>}??? 00,070X120262E22222222222 3/3A3O3d3n3333342458R99999::::;;;< <'<, ?~???? 0 00-0M00000*1W1b11111152Z2g22223445P6X6i6u66689S9]9u9999f::::::::::/;4;>;x;};;;;< <<< <$<+<2<9<@>?/????? @ T 0(0R0c0p0w00000111D1q1112222N3u3344 5566690;z<<<=> P Y1]1a1e1i1m1q1u111111{222?4P444444445 5$5.5A5e5555T6q66)7H77777 88808I8e8n8t8}8888889R999=: ;.;;;;
<:}>>>>>3?9?O?T?\?b?i?o?v?|????????????????? ` 0
000 0$0)000?0D0J0S0s0y00P1V1_1f11122#2(2:2D2I2e2o222222222 3'3M3T3n3u33B4U4g44444445;5H5]5555%6L6Y6_66666$7+7@7777778F8X8888888%9.9:9s9|999999: :D:Q:V:d:?;b;m;;;&<-<7>> >,>U>]> l
0001'191L1^111444555?5V5{55K6X7]7o7777 8889 9(9i999992:{:,;2;8;H;S;<<>W>>? :0]004455)5O5a5s5555555566'6777788 8898_8}88888888888888b9m99999999: :$:(:,:0:4:8:<::::::3;j;p;u;;;;;;;;;&<++>4>C>f>k>p>>>???&?+?>$>>&?;?j?? 4 0011r111233S555555666667 H h1l1p1t1x11111>>>>>>>>? ?? ?$?,?4?>> >>>> > >$>8><>@>D>H>L>P>T>X>\>h>l>p>t>x>|>>>> ././@PaxHeader 0000000 0000000 0000000 00000000026 00000000000 010213 x ustar 00 22 mtime=1659773740.0
distlib-0.4.3/distlib/t64-arm.exe 0000644 0001750 0001750 00000545000 14273421454 015607 0 ustar 00vinay vinay MZ @ !L!This program cannot be run in DOS mode.
$ z)))薜()薚(o)薛()()()()薞()))I()I`))))I()Rich) PE d b " ( 84 @ ` H\ < T
D J T J 8 .text , `.rdata @ @.data 8% p R @ .pdata
^ @ @.rsrc T V l @ @.reloc D @ B 0 @ A T_{ 0 1 1" @1@GI > c2 __ S[cks{CsP@uXAw`ByhC{pDa(@@ ?{EsDkCcB[ASƨ_S[cks{CsP@uXAw`ByhC{pDa(@@ ?{EsDkCcB[ASƨ_
T ! _ " Tb 6
`
b 6
`
b 6" @9b 9_ B TB c T! B T? @a T @` T L$ L!@!`` Ld LB "Tb06 @" A$B& C! !@!`` b df c B bTb 06 L` Lb (6 L`Lb 6 pL`pLb 6 p `p b 6
`
b 6
`
b 6" @9b 9_ ! !_ T 6! c `
`
6! c `
`
b 6"_8b 8_ B TB T!B T? @a T @ T! @L! $ @L!!c ` Lc d LB T ! & C$Bc " A @!!f db ` B bT 06! c @L` L (6! c @L` L 6!@ c@ p@L`p L 6! c p@ `p 6! c `
`
6! c `
`
b 6"_8b 8_{S[cks! @ SP@UXAW`BYhC[pD](@ ? @B sFkEcD[CSB{A_ @xb 4 @ 7 @` T,@_? Tt@Lqn" & " 4@ | ՠtLqn" & 5@ `N !N pn & B R @_!@ ˢ$@x 4! T$@x5 Ѡ A_ ` 7? # T @ T,@_? Tc@ ˠt@Lqn" & 4!˥ ? C T#CtLqn" & 4c aT!@ T! ˥ˠtLqn" & b4 $@xB4! T A_c@ ˢ$@x"4! Tc lT _ @8 4 @@ T,@_? Tp@L1n" & 4@ |pL1n" & 5@ a N !N 0n & B R _֥ Ѡ _!@ ˢ@8B4! T
?@ # T @ T,@_?l Tc@ ˠp@L1n" & 4! ˥ ?@ C T#DpL1n" & B4c aT! @ T!@ ˥ ˠpL1n" & 4 @84! T _c@ ˢ@84! Tc lT _ C 1 1@c1 _ 1 @1@c0 TC _ {C {A_ Q
@s/3 C T_t1@?@?T_ N N N N_ T f ib8 *
$! )&&&&&&&&&&&&&&&& @q @!
@!
_@q @!
@
_@q @!
A 9_@q @!
_@q @!
_@q @
_@q A 9_@q _H@
q L@q L_ R_ TIE) @LTB@_ H
@ TA B @qLIF ) @!LTB@B_ +T@LB T_ _@ l TC hhb8c` (($ TJ
)
@ $Z_@(@ Tc
` $Z_D@(D@ Tc ` $Z_@8(@8` $Z_@(@ Tc
` $Z_D@(D@ Tc ` $Z_$@x($@x Tc` $Z_@8(@8` $Z_@(@ Tc
` $Z_D@(D@ Tc ` $Z_$@x($@xc` $Z_ _@(@ Tc
` $Z_D@(D@c ` $Z_@(@c
` $Z_@(@ Tc
` $Z_@8(@8` $Z_@(@ Tc
` $Z_$@x($@xc` $Z_@(@ Tc
` $Z_$@x($@x Tc` $Z_@8(@8` $Z__ + TB (($ ! T_ ! T(($ a T_ a TB jTB _@ mTB @(@ TB lT TB c hhb8c` J
)
@ $Z_c
` $Z_ ΐ|ؚtl\J H _ S { @ { @SŨ_ S { @ - q { @S¨_ S[ { @ q {@[ASŨ_ S { @ h { @SŨ_ S { @ q { @S¨_ { 5 @ R1 u M@ R ? {Ĩ_{ 5 @ R M@ R ?{Ĩ_S[c{ 8 9 *
h (@
q" ѓ{cB[ASè_S[ { ) !) C ; q @B R Rn @
R|@ @Q? q3*d @ ! # @ $@c
@h% h~@ j 3 $ Ҩ# R K? q @4* RG @! j# ! yh&@c j@h% ~@ j 3/" D) R @( sB(*( @ ! K# С ^ Ё2B ` 5 iQ @? q! R @ ! 3# Fh B ҁ2 4s "T @ {è@[ASè_S[ { R R 6 Р @ 2R ? 44 R$ A C &! @ * @! S 5 @ ac @ @ 2R ? 5c a ` 4 R @! q2 {è@[ASè_ { q T Q q T( B` ( H@R!R y @I ? R{_ { U@ ?ր 4 qa T@ T @" R! R ? R{A_ _ S{ 7g
{S_ S[c{ R
R
@ R
TS T TS T TdT@ T @ ? @ @ ? @ ` ? R
5 R
2 X T A@ ? ҿW T A@ @ ? ҿV T A@ ` ?
( T =@ ? A@ ?ֈ
H T =@ ? A@ @ ?h
H T =@ ? A@ ` ?{cB[ASè_{S[ C
< S_ q$(@ T+ @t}@ _ T(+ F vtb b T҈@ h T`CD s" T5 \ )@ R ? Q
q T E@ ?C[BSA{è_ S[ C"{C I@ ?( 1 V (
@VD R!R ?֠ 4#@ R Aq@ T R h@RVD!R 2 @i ? } } } } } } 1 @ ?g@ r T @ ? @ @ ? @ ` ? !g@G 2g [ Q@ R$ R ?ր 5 5@ ? 1@ * RCR R ? C RL !@@VD ?;@@y8 (@! R ? !U =@@ ? 9@@ R ? Y@@ ? C M@#@ ?S[ { YA B ? s `@y 4 q@ TR
5ZAB`" ? s" 8 qb @y 4R ` 4 R R !
.@x 4R* @5h@y 4R* ` 5h.@xh5`@yR ` 4 ys
@y q Th@y q ys
` 4>@y q Th@y q `@y 4R ` 4 ys
h@y 4R* ` 4h.@xh5 {@[ASè_ S[c { @ ? @y qA T qJR RAS
@y 4R*w ` 4.@xh5( ) %@ R ?ֈ@y |@ q` T
)
Rz)x* H(9 ! xj
B T 8?5 q T?) q T
CT ѿ !"e -@K 9 Rc R R ? " * qUh~ ! Tc i)xc 3@y 4R** ` 4h.@xh5h@y !# qA R* ` 4h.@xh5h@y !a$ q4 R* ` 4h.@xh5C A% # @ & 5 UA ?֨>@y q TAR y QA ?yh 4(-x5y-h 4H-x5yLh 4(-x5y+h 4H-x5H A*A Kt" / ' '" " c
C @ R` >C _{ R {_C @` >C _ { RV $ *i% R S 4 *Z *! 5 4 !i % SH 4E# 5 R{A_ R { R{_{ y &% {_ S { R S( 4 RC 9d S4 BN q`
Th 5( RB !A 3# ` 4 RB a ! # H RB 5 RC 9* q h@ SH 4s@ aA ? A R `?e h@ Sh 4`@$ " $ @z$ @h *Z S 4U 5# R R * *O S 4C@9H 5# *{¨ @S¨_ R? R= *# *# { {_{ ` 4, !9 @H_h K ȩ5 ` T!9H_h K ȩ5; R{_ R { * Hy9 q) R)I99 Sh 5 R & S 5 R R{_ S{ 4 z9 *h 5 q Tu 4s 5( A9% 5( 9% 4 R
( A9) )9
) *)
* ( R:9 R{S_֠ R { IR (@y
k T,=@*, RH@ kA TH1@y -q T ),()@y
a )
@y,) _ @ TI
@A) TH @ A) TJ
j R
H%@h 6 R R R R{¨_ { S 4 5( !9 ȿ;{A_ { ( y9 S) SH 4 5*% *B R{A_ { ) ()G a T$ A9% q`{A_{ Z{_ S{ 4 @s X A T c ?@ ) ( ? @ |@) ? @ |@ ) ?#@C @
@H @? X (( {èS_ 2-+ 3-+ R_ R_ R_( A: ( ( :_ { V @ @ {_ ( @ q_ ( _ ( _ ` >_ { A ?֠ @yIR k! T<@ R
(I@? ka TH1@y -q TH@ 9 q TH@h 4 R R{_ ' (! S{ @) h@ k Th@ q! Ti"@H (K q T ?k T R{S_ֲ @ $ csm @ S[{ a< 5<! ! B T t@ bA ?ր?#T{[AS¨_ S[{ < 5<! ! B T t@ bA ?ր?#T{[AS¨_ ( E q_ @y-< S 5 4|= A
`N
`N+>N7)>N S%Ț*` TI h 86<`N0:n>N1
`N(>N
H! Q q S%ɚ( @T
J (>N )(}@Ӊ
H A I h 5 F
N |=
`NsnR
`N1
`NN>N/>N7 SI>NJ%Ț(>N
(
` T
k i _ k+T- T(}@
$ (! Q q SJ%ɚHI?T T
K}@
A p<`Nsn NQ:n(>NHR
`NH>Nh H>N )(}@i
H+A j@y_
k`_S[ck# { f@ @
˨@h 6 y@52A9H J@? qZ@ R j T@kB T a жR4@_C( T
@_C(" T@ 4@ q T*@"C( c `7 qm T@) k ThA `
o_ 4sA aA ?! R`?@" R @ C(@@"@@!C(h ?} @@ k T RB @@˟ k T *R4
*@_C(# T @_C( T@r` T R 4R4R4R+@B( T @B(" T@@ k T @
@ k Tk
kT * k T @@ 4B(@z! T *@J
@ R"C)S@ * @ k *T R{è#@kCcB[ASŨ_csm { Sh 5 R Sh 5 R{_ { Sh 5 R{_ S{ C 9 @ k T@ q T @ K q T@ @ 4 @) @ @ 6 @4@4 @ @ aA ?`?{èS_ csm { {_{ {_ ; @ T _ { ` {_R# S[{ @ 1a T 8 ? *@ ? T @ ?` 5 @ ȳ ? 4( hz @ ? J * ?{[AS¨_ { a ( ? 1 T ; ?֠ 4( hz R R{A_ { `@ 1 T ? h R{A_ { = (a RR ? 4
HiO R Ii R{_ S[ { jO 4 = s Q`R ?jO Qj35 R{@[ASè_ S{ 3 % R A {¨S_U {@ T% R *N * S{ q% R " L h@ *H 6 " R *% gh@; r Th@(9 ~@j@) , F
@yk ҩ!h@"9Oi@;? r T_ q! Tyk!*@9 6 yk!*9 6a@ g h@; SH50% R h@; 6
_ qA TA{S_ S[ck# { *~@) ;F @h{z
+!
( I x9 q6h@h 5L }@h@*i@h9U 7V >ԩ֚> B R *p% a T`@* h@ ;Sh 4 S? q* H H # R*X% a T ! l Th@;S 4h@;!Sh 5@ o"h{z
@)!
*@9
6 S? q* H HV >
֚(֚ {¨#@kCcB[ASŨ_{S[ck
$s/ < h@ *h 5I i"@ R*)*I@) 3F@hzuWA"!@ % hzu "I@? A T @@ R# ? 4 R*$ `@B( T# ,A(# _ B TH9 5 q T_
" TH9 ) q TJ S8J)k J T# H @kDcC[BSA{Ũ_H * S _ q( T *Aӟ
%@x ) qkaT` 郈
8J ) q _ aT_ֲ T( S[c{ K( s @t Tu WR RR=*
RR\8 x" 82 8B 8 R 8*I * 9? qcT !T R( {cB[ASè_ S[{ @t T ?ֵ"aT6( {[AS¨_ S[c{ *
@qc T# (R } R{¨cB[ASè_ R RR( ҿ 8 7 E k+ TzsH z3 R Rg( *E s |@( *F)@yj ! i!( S[c{ *7( Ekb Th~@) 6F@zu "*@_ T q T3 4 q T
qa T` @ ?zu R"4 l# (R _# {cB[ASè_ |@( *F)@yj ! iA( S[c{ R' R 8 q Ts6 !3 * HE IufS*~@
F +yj( Rh 9 R' *{¨cB[ASè_@ T@9H 6 ! ?ֈ@9( 6 A ?ֵ@"
ɚ ~@ F
@
Hyli!
( R( 9Hyli!
- s S[ { *S7( Ek Th~@) 5F@zt "I@9 6H@ T q T3 4 q T
qa T` @ ?֨zt
R"* " (R " {@[ASè_ { 1 T" " (R 7( E k T |@( *F)@yj +! i@9i 6`@ " " (R V {_S[ck{ hOh 5@R
qi R(h }@& & G h Rh` Ҳ& & Gh 7 t R 9 RR` ( GF@j(ziI!+@h H Ty " sb Q5 R{kCcB[ASĨ_ |@
!
_S[{ ,* ') t R G`jh%* Gijh @?s" Q5G& {[AS¨_ ! A S { *T " R {¨ @S¨_h@y4@y 5" R C * @ " R *3+ s @* @ { ! R R R` ! @ R{A_S{ ! R h@ ;5
S 4e) *) d ` 6 `@` & ) *{S_ S{ 3 ! R c {¨S_h@;1 Sh 4) q *r* { < SR?k3< S` T?q T EA yix
C ' y" R# yK R* 4#@y
R{¨A_ _ S[c{ *B, @ A aA ?*`?{cB[ASè_ @ hG* )3-ʚS* R @
ШGj lR
K ,Ț( ʨ-ʚ_ S{ @ *@ *{¨S_ S{ @ *@*{¨S_ {S[c s ! R ? T 5 s
@x 9c 9 S W k Cy S9OS# * V 6T s 5 @ T73b T W s 6 9 @ @ Tj(8SB(% @9S 4@HC y I*.cC[BSA{Ĩ_t @ !T3 8{S[c R V @ T 5
@x 9c 9 S W k C9y S9OS# * V 6T s 5 @ T73b T W s 6 y @ @ Tz(xSB$ @9S 4@HC y I*cC[BSA{Ĩ_t @ !T3 x S { TF R R B3h TBh T R f+ u R B$ 3 R ҇$ *{ @S¨_ S { T R R B3~h TBh T R <+ u R Bb$ 3 R ]$ *{ @S¨_ _ q T_ qDLz T_4 q T( S Q R?
j R R_ _ q@ T_ q TH0 Q qi T(< S ~ QR?
j T R R_ 0B `@ ,BA h $
R 8@ q @z T Q8 B 5 >*I
*( q Th
+ $@ 9 $@) $ K P
$@H $ _ 0B ` ,BB( h $
R 8@ q @z T Q8 B 5 >*I
*( = S q Th
* K= S $@h ( y$@ $ A P $@ $ _ 0B `@ ,BA
h
$ R
O|@8@ q @ T Q8 O >+Ϛi (
L q T , $@ 9 $@) $ K P
$@H $ _ 0B ` ,BB(O|@
h
$ R
8@ q @ T Q8 O >+Ϛi (= S
L= S q T * L= S $@ ( y$@ $ A P $@ $ _S[c{ * q 7 RM T @ @;(1 S 4@ @ @*5/ 1 T@ ? 1 Ts k+T{cB[ASè_S[c { * q 7 Rm TR @ @;(1 S 4@ @ @> S. ?# k T@ ? 1 Ts k+T{@cB[ASĨ_ S[ { * q 7 Rm T*5
@ 1 Ts kT{@[ASè_ S[ { * q 7 Rm T> S9
@ 1 Ts kT{@[ASè_ { b 9 ($@h A 5 )@i ( a" ` H@h D@i
* `@aB * i@(C 7 2* R(jb 9{A_ {S C h@@. h@ S @jA h@,@i
@K@@*@# K C ys 9?CG *CB" c@9C 4@HC y I*. *C@SA{è_ {S C h@@x. h@ S @jA h@,@i
@K@@*@# K C 9 ys 9?CG *CBX" c@9C 4@HC y I*. *C[@SA{è_( @ }@ 9*@L9 4* *? k T 8*h5 4h9 4R S Q?
j` Th 8h5i *9_ q T*8_ qT( _ k,h8 85_- @ 9@ Sh8?q T@ 8 Sihx7 Sh8?qA T 9 ?q }@m @*9j 98 * 8*5_ S[{
@
u@ BR@C (
@`
@ q T@ @? T R Rh@h 5U 4u {¨[AS¨_ S[{
@ p
u@ BR@C (
@` b
@ q T@ @? T R Rh@h 5U 4u {¨[AS¨_ S{ `6B SH 4h@ hrD ir? q T R . d j*@i 7l9 S?iq T}@ +}ӊ mij
Rh.@
*}Kitk. ! q` T q T (I8( / Sh 5 R {S_ ~)h~)9R95 0 q Ta ]* j@
@*
K! k l_l6 6h2@ Kj6 2i2 ( R : q` Ta j@
@*
K! k h_ h: qh:@)i: A Sh4h@ 9i9h@)5 i hrD ir? qT`*@S{ h6Bh h@ R m } hrD ir? q T R . b j*@i 7l9 S?iq T}@ +}ӊ hij R
h.@) *}Kitk. ! q T qhTi (I8( R S4a9b ` : ~)h~)9R94 [ / q Ta ) j@
@*
K! k l_l6 6h2@ Kj6 2i2 ( R : q` Ta j@
@*
K! k h_ qh: )i: k S4h@ 9i9h@i5 i h.@ qGzThrD ir? qT`*@{S_֩ S{ h6Bh h@ , R s hrD ir? q
T R . \ j*@i 7k@yRh = S?iq Th
}Ӊ Lii Rh.@
*}Litl. ! q@T qTI
(I8( 6 S4: ~)h~)9R94 / q Ta u) j@
@*
K! k l_l6 6h2@ Kj6 2i2 ( R : q` Ta j@
@*
K! k h_ qh: )i: Q SH4h@ @yi yh@)5 i hrD ir? qT`*@{S_ֲ S{ h6Bh h@ R W z hrD ir? q T R . _ j*@i J 7k@yRh = S?iq Th
}Ӊ Lii Rh.@
) *}Litl. ! q T qhT (I8( * Rb jR9 *`
: ~)h~)9R94 d / q Ta ) j@
@*
K! k l_l6 6h2@ Kj6 2i2 ( R : q` Ta j@
@*
K! k h_ qh: )i: 8 3 S4h@ @yi yh@5 i h.@ qGzThrD ir? qT`*@{S_֬9 q T q T q` T q T q T0@ 2 0@ 2 0@ 2 0@ 2 0@ 2 0 R_@y q T q T q` T q T q T0@ 2 0@ 2 0@ 2 0@ 2 0@ 2 0 R_ { R ; Sh 5 R h6B`9 @;(1 S 4h6B @ a6B+ 1 Th*@ i* h* R{A_ { ( R`@yhR9h6B @;(1 S 4h6B @ a6Bz* R ! k Th*@ i* h* R{A_ { `9R9 1 Th@ @*@K`xh R 4h6B @;(1 S 4h6B @ a6B* 1 Th*@ i* h* h@ 8i9h 5 R 4 R R{A_ { a9R9? 1 Th@ @*@Kaxh R 4b ` h@ 8i9h 5` R R R{A_{ 9?q T @ 7 R , S` ?9qa T @h 7 R , D R RT <@(5?q T T?%q T?1q@ T?Qq T?q T @(9 q T( ) R= I R; R< 9 R6 @*9_ q T(9 qa TJR _ q! T(9 q TjR(
< $ HaQ S? q Ti X(%Ț 6)R R?q T?q T?q T?q! T RR R
@(9 q T( R i R < R{_ { 9?q T @ 7 R , % S` ?9qa T @h 7 R , R RT <@(5?q T T?%q T?1q@ T?Qq T?q T @(9 q T( ) R= I R; R< 9 R6 @*9_ q T(9 qa TJR _ q! T(9 q TjR(
< $ HaQ S? q Ti X(%Ț 6)R R?q T?q T?q T?q! T RR R
@(9 q T( R i R < R{_ { @y?q T @ 7 R , Sa ?9qa T @ 7 R , d R RU <@(5?q T T?%q T?1q@ T?Qq T?q T @(@y q T( ) R> I R< R< : R7 @*@y_ q T(@y qa TJR _ q! T(@y q TjR(
< % RH = S? q TH X%ɚ 6)R R?q T?q T?q T?q! T RR R
@(@y q T( R i R < R{_ { @y?q T @ 7 R , Sa ?9qa T @ 7 R , R RU <@(5?q T T?%q T?1q@ T?Qq T?q T @(@y q T( ) R> I R< R< : R7 @*@y_ q T(@y qa TJR _ q! T(@y q TjR(
< % RH = S? q TH X%ɚ 6)R R?q T?q T?q T?q! T RR R
@(@y q T( R i R < R{_ S { h9
Q_ q T (Y ( R $ M ! f h2@ 2i2 AR R i2@(Sh 4(2h2 R" RR R RhRi") SH
4hA9 5l2@C y 9S 4Sh 4R l 6hR S 4RC 9+ m9R S aQ?
j TSh 4. R R S QR*
N 5 5C Rhi)8aq TqRA T RG hi)8k i6@ *hR@ r)K4K Tc *R`h6B @;(1 S 4h6B @ h*@ i* dB c *C `, i2@(
S 4( S 5c *R` R h*@(7h2@ S 4c *R` R R{¨ @S¨_ S { h9
Q_ q T (Y ( R $ o ! h2@ 2i2 AR R- i2@(Sh 4(2h2 R" RR R RhRi")< S 4hA9H 5l2@C y 9S 4Sh 4R l 6hR S 4RC 9+ m9R S aQ?
j TSh 4. R R S QR*
N 5 5C Rhi)8aq TqRA T RG hi)8k i6@ *hR@ r)K4K Tc *R`dB c *C ` i2@(
S 4( S 5c *R`r R= h*@(7h2@ S 4c *R`e R R{¨ @S¨_y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y y {S F h@y
Q_ q Ti (Y ( R9 $ ! r h2@ 2i2 AR R i2@(Sh 4(2h2 R" RR R RhRi")i S
4hA9 5k2@
yhS 4hSh 4R k 6hR hS 4R y* l@yRaQ j ThSh 4- R
RQR
M 5 5 R(y*xaq TqRA T R (y*xJ i6@
*hR@ r)K4K Tc *R`h6B @;(1 S 4h6B @ h*@ i* dB c * ` i2@(
S 4( S 5c *R`g R h*@(7h2@ S 4c *R`Z R R@SA{è_ {S[ h h@y
Q_ qh T (Y ( R[ $ ! h2@ 2i2 AR R i2@(Sh 4(2h2 R" RR R RhRi") S 4hA9( 5k2@
yhS 4hSh 4R k 6hR hS 4R y* l@yRaQ j ThSh 4- R
RQR
M 5 5 R(y*xaq TqRA T R (y*xJ i6@
*hR@ r)K5K Tc *R`tdB c * x i2@(
S 4( S 5c *R R h*@(7h2@ S 4c *R R R[BSA{è_x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x S { j@
@*
K! k u_ @ b>@a9`@*t& @y S 4( RhR9)}S
H%h& I%( 85H%)R9iR R{ @S¨_S { j@
@*
K! k u_ @ b>@a@y`@t& @y S 4( RhR9)}S
H%h& I%( 85H%)R9iR R{ @S¨_S{ C h2@4 Rj:@ 2i2 J6hA9R Q?
j RR*j:
* 5h9 q T
R qa Tt: * RHu}@`bt S( 5h2Bh @ h.BA uQi: ib(B (h& j@
@*
K! k p_a2B a @ h.BAӡ @abcb h.B#H"Ag"@ e9f:@ # h2@ S 4h:@ 5a@`&@hA9R Q?
j Th2@ S 5a@`&@j&@K9 q Th2@J j& 2i2 K9h%Q S? q T X(%Țh 79q Th2@kRk9 y i2 K9
k 4( 85(
hR RC {¨S_ ! S{ C h2@4 Rj:@ 2i2 J6h@yR Q?
j RR*j:
* 5h@y q T
R qa Tt: * RHu}@`b S( 5h2Bh @ h.BA uQi: ib(B (h& j@
@*
K! k p_a2B a @ h.BAӡ @abcb h.B#H"Ag"@ e
9f:@ C# h2@ S 4h:@ 5a@`&@Ah@yR Q?
j Th2@ S 5a@`&@j&@K9 q Th2@J j& 2i2 K9h%Q S? q T X(%Țh 79q Th2@kRk y y i2 K9
k 4( 85(
hR RC {¨S_ ! { b>@a9`@j@ S 4
@*
K! k c_xa2B @ab h.BAd@`B 4( Rh9 ib(B ,
@*
K! k h8 9( RhR ib(B R (h& {A_ S { 5 RuR9j@
@*
K! k b>@a@y`@t_xib S 5(BC 9C c@G 9 h @ 6u9 (B ( yib(B RuR (h& {¨ @S¨_ S[c{ j>@*X S_- q( TI (I8( t @6 Sh@ 4 ! i )85}@7 ! i 5_83 t j@@V S
4 @*
K! k hx}@% @*
K! k u_x t j@@ S
@*
K! k u_ t j@@ S
4 @*
K! k u @*
K! k u_ ҉@(S 4 )2 j:@ 6( Rh: (y A}@ `b @ y R9" ** T *)@ S 4hR@ 4h&@ 9? q Th&@
R i& * 9hR@ iR R R R{cB[ASè_ֱS[c { j>@*X S_- q( Ti (I8( t @6 Sh@ 4 ! i )85}@7 ! i 5_83 t j@@V S
4 @*
K! k hx}@% @*
K! k u_x t j@@ S
@*
K! k u_ t j@@ S
4 @*
K! k u @*
K! k u_ ҉@(S 4 )2 j:@9 Rj 6y: (y A}@ `bU @ y yR9" ** T# *@ S 4hR@ 4h&@ @y? q Th&@
R i& * yhR@ iR R V R R{@cB[ASĨ_ְS{ j@
@*
K! k t_{" 4j>@_- q Ti (I8( j* h*@ hRy y h9 9( Rh9 R % R R{S_S { @
@*
K!
G) s_9@ 15&
S 4 ($& 3$( R~@R9 (%& 3%~@ *R R{ @S¨_S { @
@*
K!
G) s_@y@ 15& S 4 ($& 3$( R~@R9 * (%& 3% R q Th9 4 S@ @*@Kkxrh kTR R{ @S¨_ { @;1 S 5B q |@ TjFyji@ ,! 9 5 q TjFyji@ +! h@9 6 R 9 R R{_
@I@ THa@9 4H @ I H @ a@9 H @ I
@H @ I
@H@ 9 @ Rh@ i _
@I@ THa@9 4H @ I H @ a@9 H @ I
@H @ I
@H@ y @ Rh@ i _ {S C hRA9( 4hR@ q Tu&@ R&@x d@# 5@ 4h6B @;(1 S 4h6B @ h*@ i* dB c # `2 hR@ kAT h* h6BbR@a&@ @;(1 S 4h6B @ h*@ i* dB c ` RC e@SA{è_{S TC hRA9 4hR@ qM Tu&@ R&@x d@# 5@b 4dB c # ` hR@ kT
h* bR@dB a&@c ` RC 3@SA{è_S[c{ hRA9 5hR@ q- Tu&@ R Rc@# yC h @ * q- Th6B#@y @;(1 S 4h6B @ a6Ba # k Th*@ i* w* hR@ 6kT w* h6BbR@a&@ @;(1 S 4h6B @ h*@ i* dB c ` R{¨cB[ASè_ S[{ hRA9 5hR@ qM Tu&@ Rc@# yC h @ * qm T#@yb `hR@ 6kT
h* bR@dB a&@c `8 R{¨[AS¨_S[ { * 4@*@
T(a@9 4h@ H @~@ 1@H@ I @H @ I @Ha@95 T h h@ i {@[ASè_ S[ { * 4@*@
T(a@9 4h@ H @~@ 1Ӳ@H@ I @H @ I @Ha@95 T h h@ i {@[ASè_ S[ck{ 3@ * 3 8u@ T @8 @;(1 S 4@ @) @ 1 T @` @ q T@ @;(1 S 4@ @ @R 1 T@ !T h@h 5U 4u {kCcB[ASĨ_S[ck# { @ * ~@v@ 7? T R@ '@x @;(1 S 4@ @I @9 R ! k T @` q @ q T@ @;(1 S 4@ @ @R$ # k T@ ?T h@h 5V 4v {#@kCcB[ASŨ_ { D R Bc + C#C
{Ȩ_ { & R Bc + C#C {Ȩ_ S[ck{ 7 R9 s T i T @ 1 T @ q T " @h 8 1A T ! T @ q T 6 9 1 T HR R y {kCcB[ASĨ_ S[ck{ 7 R9 s T i T @ 1 T @ q T " @h 1 xA T ! T @ q T 6 y 1 Ty HR v R ' {kCcB[ASĨ_ S { *S a R {¨ @S¨_֟
qT#*K *"* S{ _ q Th@; R j Th@; r Th@ q T`@; |@ *F)@yj +! i9)7h9 5 5" R Ҩ @h@ (ˋ )ӟ k Thӟk T j"@
?l Th@( THh i@ R(Kh R{S_ S { h@*;5
S 5
R 8 jR I_)y I5;* Sh 5 q T R { h@ h i@;( S 4jR I_)u I5;
h@;)R
q Th@;!Sh 5@Rh" `@;*F @ T R{ @S¨_ !|@O{ $@ T
R dR b y J Hiix(% xh 4! с y
HR R@R R{_@ @ @ @y 4* @y
*
4
* *k T-@x *i5i 4,@x5 @y H 4) @y *) 4
@y * *
k T-@x*h5 5,@xh5 $ x
@ @_{ k
R A` H @{_S{ @h@ @ |@*F )@ yj)! *@9 6: * G
(R @*{¨S_ { 1 T-
5
(R 7 E k T |@ *F)@yj )! *@9J 6S )C c s
(R {è_S { *I a T R @ qa TH!C9 7
qA THB9 6 R9 @ R6 T*2 ? 5 ? **~@ F
@(yk I! ? 9 4* R{ @S¨_ S[{ `R^ R {R" S ) 4 (yh 4) ( A6 A R R ` 5S v R`RZ *{[AS¨_ R IS { 3 yh 4(-x5(i@A (y h 4H-x5H ˿" T`@xux q T( ` 4i@h@ { @S¨_ R # R{ a R @;{_ {S[c K R Rl c T y@ @ @yJ 4RH = S?e qh TH y.@x*5 RU R Ri * 5& HR # @G ~@ T y HR @R= A ? T< L T|Dӊs/ s R 4 Rh sB R @ @* @ R. 41 * HR TR h_R ka T`B 8 * EcC[BSA{Ĩ_ S{ C ?c o@9 4 @HC y I{èS_ C ߈C b R %@x+$@xHQ e qI hQLi e qhK 5l 4B B_{ Ah 5 R K A {_ S[ { R 4 = Vs R9 C @h@ ( &&@x qB T @
ylx 6h@il8 S c @< S&@x qB T @
ylx 6h@ il8 S c @ < S K 5t 4s ѓ@9 4 @HC y I{è@[ASè_S[ck# { - R {è#@kCcB[ASŨ_ֳ ؚ T T R3 ؚTh@; R j` Ti"@ R
Rh@; R j Tw@ 4
77B T*_C7 Ta@~@ӂ
a Rv
h@B7j@ZC7 KHA7i h ~@ B) T{@
W 4I 5 >
K_C7C Th@ h f@*
4@7 |@Z @@
1 T @ Z ( @ 9i"@
T R4
HR zjR I_) 2I5 jR I_) 2I5;@ ؚl S[ { u T Ry
R * {¨@[ASè_<, 9 S[ { *- s j@K_
T(A k T? T @ T Ra (A a T [ w@v @" q TI +A ? )A ? T@I
v@ k T@ T k T k TI k T k*! T(R4R% RR" hRtR HRTR RR k T k TI k T k* TRR RR RR HRTRh aA ?* R?v aA ?*?w R{@[ASè_֑ @_ _ @ h@* )*-ʚ_ _ _ S{ @ h@* )3-ʚs R aA ?`?{S_
@ RI i K,ɚ
h _S[c { ( ( v " R8 q T qUR @ 8h 9s 8 *q! 4@ 9h 9s 5 45 q` T& qT 8 R9( 4 q` T % q T 9 4v " (@ R ) 9+ R
R 8J qqT q TJ 7 49 qa T q RJ}S* 4J Qs w 9s @ *59 4 5 qIz TK 4 ` 99s !! 4@ 9h 9s @ s 9s @ V (@ ) {@cB[ASĨ_ { b T B > ? T)| ) T
! &
O
{A_S[{ *u 4 Q q T R RS B R B ( 3@s h9H 5B c ,A" R
R0 c q! T@ t Q HY C [ * 4 @ @ H@
h@) iY
R*{è[AS¨_S[{ a`@ h@H N @ 4t@ @ R R Rn |@v A @* R R` @ 4 R2# Ҹ @`@ Ұ {[AS¨_S{ @h R P s / ` R Ғ *{S_ S{ @h R s Z ` R s q *{S_S[ { 9 4 q)h 4H 85H 8H5 - 9 4i 4H 85H ? q T! u ` 5 " ? h@ 8 @4 2 / {@[ASè_ R yS[ { @y Ҩ 4 qk h 4(-x5( A*
@y5` 3 @y 4=
= Sh 4(-x5( A7 _ q TA u ` 5 " h@ @ {@[ASè_ R 'S { @ h@H R R R |@u ! b@* R Rs @ 4 R!" ҩ h@ R { @S¨_ S{ @ @` TS h@ @ {S_ S{ @ @` TS h@ y @u {S_ { a`@@ h@h ` 4`5`@{A_ z S{ a`" @S h@ J @F @S h@ > @: {S_S{ @ a`@@ h@h ~` 4V`5`@ {S_ t S[ { ( *Cӿ v д@ bA ?ր?s T{@[ASè_S[{ ` T u@ bA ?֠?ր 5T R{[AS¨_ S{ @ `@9 {¨S_ S { "E9 5) R ;Ո@ @ 5
@K (@
` TI3-˚ aA ? R `? A ? q T @ @ 5 a !
@ @ 5( R"9
@) R 9{ @S¨_ k_csm { *)b 5 A ?֠ @yIR k! T<@ R
(I@? ka TH1@y -q TH@ 9 q TH@h 4*3 c C 9 S C #H RI R)s G y@ 4{ĨA_* { * q T1@ @*!SJ 5 ?ֈ ! * ?* a * ?S{ ( (a *C R ? 4 ) @ ? aA ?*`? @ A ?{¨S_ _ " RA R R" R R R} RA Rz
@ @ RI k K
T ,˚*
ʊ _ց R Rh { R FR J; R{_{ @Q ur! T 0@q T !( ; R { R ,R{_|@?@q - F@yl !*@9+9O T? @q T(@@Q yr@ T? Aq TH2( 9( Ryl%H 9
H2( 9H RH ( 9 H2( 9yl%_ 9o 5 R k 5 R q R( R _{ ? ? R{_ a_ _ S[{ @ C 9 ' " ` Tɂ
h@ T
[" ` s" @ {è[AS¨_ ) R ;_{ S C c C R R){¨_ { *Z CJ R) R rI 1 Ts 4 q` T
q T R
y 2 H *{A_ A;_{ q T R y
H_@ 5;*{_ !_ S{ @? *@` *{¨S_ S{ @- y *@N *{¨S_ S[c{ @
@- @@* ʩ@ V-˚* ʩ @N-˚* M-˚
TC @(
U# T! T u ! Ҽ @ *C
胊 k T @@
RJ K R @*-ʚK @
R I K@.ɚ ! I@
R+ @ J K -ʚ@+ H@
R @ HK@-Ț+ H@ {cB[ASè_ S[ck# { @ @k ? L@i@* i@ U-Κ* ʩ ?
T-ΚH T " џ T@ `T ʙ hcA3-Κ ?`?@L@+@ h@
h@M-Κ
K-Κ`XT
T= L@@ @, @H@ @*@L R{#@kCcB[ASŨ_ A { S c C I RH R) {è_ `
@ @ T @ R_ { S c C 'H RI R){Ĩ_
( R_{ A R{_ { R{_ { @d! ! R{A_ { R S{_ S{ jDH_ QH 5;( 5`D B T Bh R{S_ { `D `D `@ `@ R{A_ { A) S{_ { S 4 GH R A) S{_ {
@ aA ?`? " { $@ T R R b 9 J Hi8( 8h 4! с 9 HR @R R{_{ ,! ` R;! )AH 6` >` R5 7 6 6 R? k T R_ RS[c { h@*w S R | 4
Q qT C 6y@ R@- 49m
@ S
ix 6 9 l q 2 q ` T q T, 49l Ru 4B qa TB S?% qh T Q
~ S?e qh T^Q S?e q QI T h 4HR 9 Rk S aQ?
j T qRl ѵl 49
k Tx *l@ l t9l R q U 5 >
KB S?% qh T Q
~ S?e qh T^Q S?e q QI T 1@ T k T
k T
k
Kzi TR " Rh@7* 9l h 49 k T= 7@9y 4 @HC y Ii@i h@( R1 **H S 4' HR w 7 @96 4 @HC y Ii@i h@( R 4 @HC y Ii@i h@( W 6K@9 4 @HC y Ii@i h@( *{è@cB[ASĨ_S[c { @*u S R o 4
Q qT C V@ R3@y( @%@x* R;@5 2 qh QR j T@%@x zrR T q T qb Th Qp R k Tq
Tqb ThQg q Tqb ThQa %q# T%qb Th%Q[ 'qc T'qb Th'QU )q
T)qb Th)QO +q T+qb Th+QI -q# T-qb Th-QC 1qc T1qb Th1Q= 3q T3qb Th3Q7 5q T5qb Th5Q1 B9q# Tj9qb ThB9Q+ B;qc Tj;qb ThB;Q%
K q T qb Th Qp R k Tq
Tqb ThQg q Tqb ThQa %q# T%qb Th%Q[ 'qc T'qb Th'QU )q
T)qb Th)QO +q T+qb Th+QI -q# T-qb Th-QC 1qc T1qb Th1Q= 3q T3qb Th3Q7 5q T5qb Th5Q1 B9q# Tj9qb ThB9Q+ B;qc Tj;qb ThB;Q% {ƨ[AS¨_ { S C 9 C c #R) R)s G C@9@ q@ {Ĩ_S{ i@;( q! T?r Th.@ Kk q - Ta@* k TjR I_) 2I5; h@; S 4jR I_)y I5; R{S_ { R ` 5h@;- S 4 ` 5 R {A_ R { h@;5
S 4h@;S 4`@mjR (I_)
I5;~ {A_ { RC @h R{¨A_ | P ;_S[{ G )ᏹa (
Ѷ T@S h@;5
S(5kR h_ 2i
5;7h* 7 _h _ RR _jR I_)2I5;x {[AS¨_ S { C @y A ,@x? qT5 R?q` T?q T?q! T3`R R * 3!RJ R
R R R R) RD R RE Ҩ@y**
4 Mq T T q T q T q T q@ T 9q T Iqa
T 5s 2 s2= r Ts22 ' R4 f 5& R37j 3 30 5s2/ R q$ Qq T q T q T q T q T q Tr` Ts2 r Ts2
5Jy 5J2. R q ra Ts2 s `6 R s2 ) R? q
5 q@y .@x qT 5@yH 4R @ @{¨ @S¨_ֈ
b 5 (@y (-@x qT q!T4 @y .@x qT P 5h2I AG 5h2 >`5h2 jix q T H-@x qT5c 9 S { *&# @9 h 5 @0R*C 5 HO @ IjR I_) *I5;@ ~ h {è @S¨_ h a { C H@ @ @{¨_ S{ @ @ @*E@I_) I5;`@9{¨S_ S{ @h@@`J@ ^ `J@ D T
T@H 5 J @{¨S_ S{ @@ @@!@@@ `@{¨S_ S{ @@ @ E@ _ Q 5; 5 A @ T`@{¨S_{ c R# c # R R) ' + R' R ( / h A%@ C @ AK@(E @iRIyy@ y@ p C {Ũ_ { O{A_ { R R R R) @h A%? T 7@ 8@4@ -@1@ 1@.@ 5@+@ %@(@ )@%@ =@"@ A@ @ A S c C ss C :{Ĩ_ S{ J@ DJ@ T
T@H 5 J s {S_ S { h ? * B 1 T} T B `4y Ҭ B ҇ 5B ~> h * ? { @S¨_n S{ B 1 TG @ T B [ 4y w B R Ҝ M 5B I ҏ {S_?S { h ? * B 1 T T B &`4y B B g 5B Zh * ?{ @S¨_ { 1a T R R R{_ { `B 1 T h R{A_S { h T ( h ! E R ?` h !` 4 4E R ? R { @S¨_{ A # RC {¨_ { A # RC Ҟ{¨_ S { 9 5 yK C @*R(
@
ka T ' q (@ s @9h y R@9H 4 @HC y I- @9c w 4@# @ q TkK T
@ !RQ @ 5( @( T9 4 @@ # R
@!R? 5?HR R{è @S¨_ ҡS { # y
@ TS R7 s h {@ TR R+ @)R
@ k T#@yc S ` qm T @ @ #@y q T @ T RHR @R@9 4@HC y I{Ĩ @S¨_t u 9S ( Rh * S # RC R 4@5S ` Rh ? qT @ T RPHR t@R c< S { Di@? T I C?ja T ` {A_ { Di@? T I C?ja T
` {A_ S[ck# { C K@ 9 q S*. ( TxHR )@R @Ht a T@* R* ` 4 9 R+ R*iSKA 9 9 Rh 9@s R I S6 y _)LR T{ 9@ @8 (Rh 9w s
t 5 R @}@ @(9( 9@ @I Rҟ qm T@ +@h% = S+ j= S_ qi TH
= SH Qj 9= s !DӔ Q6b7@ S 4k Rl9 S Q?
ja T{ 8 T q @ T i 9 h8 h 8 q T*RsB49R qHkSk Ai 9@l Ht ? *? hRh 9_ 9 T }H
ɚ
9 a T_ T H
ɚ
i 9k D J TIH
ɚ
i 9k H i 9 9 R@9 4@HC y IC {è#@kCcB[ASŨ_S[ { *
`@_C1C S* @[@ *C q qן
H ` 4 9
+@ RC *** {¨@[ASè_ S[ck{ * qh % ) w S* S TlHR @R{èkCcB[ASĨ_C 6 4@ q* qm TH9
h 4( 85(
@ @R qa T 9 q
Th9@h 9(}@ @*9j 8@ 3 3 Hi "12% 5`
w 4Rh 9@ 9? q T@
Qm 6
Kz 9qk T }( `h
9+}l}K R h
9) qk T }( `h9+}l}K h 9 Kh9
h 9? q T 9 q Tb @9 4 @HC y I R R Ҧ QgfffS[c{ C * S[@Rw 4H Q k T@ q**H_i38 8@ q TRh 9s @ q, T 5@ 9( R? q@ T R 4h 4t h9h 4( 85(t mx 9 t( q T9h 4( 85( ^@ }@ @*9 9@6K q
VzԢt 4h9h 4( 85(`4 G~@R@9 4 @HC y I R{ècB[ASè_S[c { @*C ?} C * S* @c@ *C * q@3 Q v ` 4 9 @ Q? 1$Uz T k Th85 87@$ RC *\
7@& RC ***{¨@cB[ASĨ_ { ) S( * T 9R{_ 4R 9 8@ Tc ш S R-y SN Qo / ,yk9 h 4H 85H 臟
+ /yk` 5 R R һS_{ @W< *@K%ךs= S 5" q7* 5@h @*%ךL= S! qi T R T( !ך * _@T q TK @*%ךK S )L`
q T3 4@ q Ts 4@H R{_AS¨_ S[{ C * R pRw T+q TQ q RH T& RG7@t T@a T R a T R s(*K ` 2 S*]S D 2[@ {ql TQ yr Tq Tq +@ * *
: q Tq T+@ * *
+ @ } * #@* * q'@ ˁo ` 4 9 +@ R *_ +@ * *
C {¨[AS¨_{S[ C @< S;1 S 5 1 @ T 1 T *h~@ Fhyl
@
I!
(9 S? q T 1@ T 1 T *h~@ Fhyl
@
I!
(96* # < 5@ R q T# 8! 1 T@s k T R @ Q 6* < S @ y@* *C A@[BSA{Ĩ_ (@ Q) I 6 ( @ 9) @ S* * _֨ @ )D
@?
_ { @ R_ ` T R[ TI ` 5 R R{A_S{ Sh 4 RF T A' @ R? T a' HO Ij@;R_j TjR KPRI_) *I5;Ո@ ҭ @ R hr h I Rh i i" h R@ R{S_ { S 4h@;% S 4jR PI_)
I5;" ~ {A_{ A 5 HR A{@_ T {_S { s R* -R # U{@TC @ @ f **! R 5R Q@9 4 @HC y I{è @S¨_ AH 5 S { C gs R# {@ TR @@ c @**" Rc _ 5R Q@9 4 @HC y I{è @S¨_ S[c{ C * q ** Ta~@{ k ***C {cB[ASè_{ < SR# y ka TR% c #@y q Th & @ ykx 6@@ ik8 S @ @ % RK # RC R ` 5#@y '@y@9 4@HC y I{Ĩ_ S{ 3 gR {S_h@;5
S(4h@;1 S5h@;SjR 4I_) 2I5;I_) 2I5;h@; R ja T h@h b"@a@: ` q T q RR+jR I_) *I5; h@; r T 1` T 1 T *~@ ) F
@)yk H% ( @9IR
q TjR I_)2I5;h"@ qa Th@;S 4h@;!Sh 5 Rh" h@j@ Qi H @@9h b T _ S[{ *4 h@9 4`
@3 9~ N 9 5h@h h@9 4`
@' 9@ R `
q qh 9i 5h
@ y R !R* |@5 H ?֊ @% i@ i Th@9 4`
@ 9R `
q qh 9i 5d
@ * !R* |@ I ( h R{[AS¨_S { *4 h@9 4`
@ 9~ R @y 5h@h h@9 4`
@ 9 ҕR `
q qh 9i 5h
@ 9 R R*n |@5 H ?%F @' i@ i Th@9 4`
@ 9jR `
q qh 9i @ 5d
@ * R*F |@ I ( h R{@ @S¨_S[ck# { R Rq @ H SRRC C 9G 9K 9 @ i *t 5Ȏ@hWB(C ( C탉 ҭ j@H9
h 4( 85(
T" WB T˂@H 9h 4( 85( I ! @ 5@wk4" T R *C @ T*{Ĩ#@kCcB[ASŨ_ R > S[c { 9h 4( 85( 4 TR{@cB[ASĨ_ ! қ D 5> 5i@? T`@ Ҁ ҅` Үi@ ( i C TҬ @ ҝR Ҙ* `" i
i@5 h@ ! i R R {S[c# X 9 Q S? qh Ti&Ț 7 T T 9? qA T T y ( Q S? q Th&Țh 6) R R ? q K c9e@)R
@ k! Tc@9 4@HC y I"R Ic@9 5 4@HC y I" R 4@HC y I RC@ R q RH R ? T 1 *^ &@)7C 3 9%@)R
@ k! T@9 4@HC y I"R @9 5 4@HC y I" R 4@HC y I R3+@ q 9 q T9h 4 qa T9 4 *3 5A9h 4H ?֠5"@
+C T
@
aA R A9h 4H ?cB9h 4C@* #@cC[BSA{Ũ_ 4 S { * h@9H 4 9~ 8 @y 5h@h h@9H 4 95HR @R 9 + h
@ 9 R R*C |@) H ? @ h@?Td
@* R*- |@ I ( h R{ @S¨_{S a H ! T|@Ӣ RC ? 5H ? R) S S# #9[@)R
@ k! Tc@9 4@HC y I"R ?c@9 5 4@HC y I" R 4@HC y I R C{#@ .SA{¨_S[{ @H@ @*E@Aa '@ " R_R " R2R V@ @*E@Le@ %h%
T h}T B@ @*@H_ QH 5;( 5@ @ @ A @ T@ @@*@hE@H @*@KE@i_) i5;@%{¨[AS¨_ q T q` T q Th A
q h
h h _ { *C ?
1 T( R(
I (! 1! T( R(
I ( ? * 1 T( R(
@
@@9 4 @HC y I*{èA_S{ b " R R Aha B ) R
˟ His8) Qh 85fhe
Rhii8J Q( 85{S_ { i `@(R k
TH A C ?
4 R ( 8 qT R[@9 9[ 4 *@9 q TI(8
kiT(-@85e@ R R ! R ҕ g@ RaA R R g@ RaA R @R of, R
R%@x 6iB,Kig8(a@9 2(a 9 6iB,Kif8(a@92(a 9 RKi/8 J Q5 R
RhQ e q Th} QjB(n SIa@9( 2Ha 9
hQ e q( Th} QjB(Ia@9(2iHa 9. S Rh e9k Q5 @{¨_ S[{ *6 SS *%@ *E@ @ ka T R Eҟ @ERE@ * * 1 T`R *{Ĩ[AS¨_V 5N@
E@H_ QH 5; 5@ E@ (A @ T( R @ E @ I*C_jT ' R R)S c C qV4@ @ IS { C I?j TJ@h F@ RF@@ T h_ Qh 5; 5 A` Tc@F i_) i5;ՠ R { @S¨_ S{ h9h 5 ' (Ah
)A h& @ cB ! R]( R(9 R{S_{ B '{_{S[ 1C v * 4 !
R U}@Ө~ iv?k@
TJ _ q#TRk@ TH Ȁ> S ?ր 4(Rka Th : y
p H A * ?֠ 4ub " R R&@t q T@9 ( 4(@9 4+@9kH T Kj Jj8k Q 2J*8J k5(-@8(5) R) Ji8?q 2J)8cT`@) R` Ri
J 5 9 wb " R R A! Ҏ R B 2
j@9j 4h@9( 4_k TM qB TJm8J ig8(*J-8h@9 _kTj-@85 Q5( Rt )*
`l2 R *k QJ yhx% xk5
RC @[BSA{Ĩ_S { * C **@j S* e@9?ja T 4@@ jx*
Rj 5 R R@9 4 @HC y I{è @S¨_ * ҃ R R R k TR K % q TTR(%h 7 qa T R ӚR k T(՛R ki Th֛R kTR k`T(R kA T! H a R K qR釟 kH TR K % q TTRH% 7 q ӚR k T(՛R kI Th֛R k) TR k T(R k` T!x R? q? qi 4G H a S[ { H ? U @y 4 = h 4(-x5( A* k
h@y5h 7A* R R R|@ * * R R` 4 H ?{@[ASè_ S { H ? t # @y 4 = h 4(-x5( A* k
h@y5h 5Az s ҜH ?{ @S¨_ S[ck# { * *R RH V` T t@9 @ Ts t 4@ t@@A Td t 4 /` Xt@T @H % N@ t@
@ 5@ i8? q$@z` T@C u@( zu0z 5zu (@ ( (@h. Җz5 4ˡ
? # T ? T } t 49h 4( 854ˀ
! u R
` 5 * _ q_ 8 5HR R R *{#@kCcB[ASŨ_ R " S[ck{ * eR R V` T T@@y (@ T T @ 4 G T@(@A T T 4h h ґ@( T@4 ^@ ҇T@ A@ 5@ yyx? q$@z` T@C ˕@H zuix 5zu (@ ( (@hg XT z5 4ˡ
? T ? TS D } T W 4yh 4(-x5(A
A u R
5( H q? x ? 5HR @
@ R R *{¨kCcB[ASĨ_ R US[{ {[AS¨_h@ H@) T i@ (9 h 4H 85U ˠ ! Ұj3 js b@ j 5i@ R | S[{ {[AS¨_h@ H@) t i@ (y h 4H-x5H A A uj3 Ҟjs b@ 5i@ Ҕ R A { 1@*@K @ 7C m@ R q@ T R{¨_ H J R R q(H
_S{ A%`@@ @ Ta`@@ @ T\`@@ @ TW`@@ @ TR` @ @ @ TM`"@"@ @ TH`&@&@ @ TC`6@6@ @ T>`:@:@ @ T9`>@>@ @ T4`B@B@ @ T/`F@F@ @ T*`J@J@ @ T%{S_ S{ A%`@@ @ T`@@ @ T`
@
@ @ T `.@.@ @ T`2@2@ @ T{S_ S { (@ ҟ @s T{ @S¨_ { ` ``BA ``@`@`@ ` `b`B`A `B
`RA`VA`ZA`^A{A_ b R I I
@y
4( @y_k T ! ) @y( @y K_{S[ck+ * ***t 5H@
@ q)R( R! R **% *v 5 R; ~@ A ? T< L T|Dӕs/ s R ? Rh sB R**! R*` 4H a ** ? * R h_R ka T`B EHc@9 4J@HC y I*_ K+@kDcC[BSA{ƨ_
@ I_) I5;
p@ I_) I5;
x@ I_) I5;
t@ I_) I5;
@ I_) I5;Ո
!
RH_
TL@ _) 5;H^ L_ _) 5;J k Qk5 @U S[ { i~@i A%? Thr@ @h 5`z@ @ 5`~@r`v@ @ 5`~@`r@`~@h@ @ 5h@ h@ h@ `@`@2 !vt R_ T@ @ 5@^ _ @H 5" Q5{@[ASè_֠ H 2 T
pH_ H 5;* _ { s H 2 Th^A;Ո 5{A_֠ H 2 T
pH_ QH 5;* _
@ I_) QI5;
p@ I_) QI5;
x@ I_) QI5;
t@ I_) QI5;
@ I_) QI5;Ո
!
RH_
TL@ _) Q5;H^ L_ _) Q5;J k Qk5 @_S{ 9 C I?j` TJ@S RW DB Rv {S_ S{ @a T t@5
`T {S_S[{ U ՚ TR ] ҵ~j nU T R{[AS¨_{ H ?ֈ
{_ֈ
R_S[ { @ TW v@ bA ?? S 4sB T` T Ts" h_ u@ bA ? R?sB h" T R R{@[ASè_S[{ TV u_ bA ? R?sB T R{[AS¨_ֈ _ S{ S H aA ?`?` 4 R R{S_ { R @+ HE*S-˚ R{A_S{ @z @+ H E*T-˚`@{¨S_ q T q T < q` T T q T X q` T ( !
( a ( (_{ S C c C h Ri R){¨_ֈ ( _ S[c { * R3 RC 9" q, T` T
q T q T q T$ . q@ T> q TV Q q T* ! a 5 {è @@cB[ASĨ_֩@H E* (@ k T)A ?
aT uR &7! RC 9 s 4` R@ 4(@ V-˚ ` T . q T"R% 6@ " q T@ R " q TH
E@
K iEH _ T_ JA (@ s 4` R a T R" qa T H aA ?a@ R? H aA ?*?֟. qhT"R%6 " qT s 4` R` Rg{ 1 T(R 7 E k T |@ *F)@yj )! *@9@ (R R{_ S[c{ U h 7 Rt R }H
6}~@|iw- 4` 6 Q k-T |" (ih7 q T }|J H
ih R{cB[ASè_S{ @h@ @ |@*F )@ yj)! *@9
6H
?` 4 R H ? * (R @>*{¨S_ { 1 T(R 7 E k T |@ *F)@yj )! *@9J 6S )C c s w(R ( {è_{S[ck+ ͯ *~@ :F@H{y xC"3 " (@/ hC" I (!
? # C@ R R
@' T~@ )F+R{9 _ k 8 R T+yh
R h-"*9 4 qKT@ q TH{y"*@9 8.
K6 Tch"c
*, i8k QH 85
R q- Tch8I
J _k)8kT H{y Q &k _ 9M5cH R q) R8@ : ` T Q i@98 (k T q* RI RX@#C & Ts6* I{y
&
l@9 q T&
j9B 9h R
9h 99 1j9H S x6@v
TB 1 T " 1
T#@ ҥ R* Rs * 4H /@ s * ? 43@@jK @T k T+ q TR3 yH s " Rc ? 4 @ 4@ @ TF'@@ R T
H{y
Ji8 )&j 9}@_ T !
R mT
H{y "+
Ji8j 9}@_ TH{y " * 9J{y * h@9 2h 9 H ? @CB9 4?@HC y I@*+@kDcC[BSA{ƨ_{S[ /(ҵs/ |@ *F)@yj RtB")! 7@ Tc c Rc1b Ti9s ?) q T 9! 8
TK H C *c ?@ 4@)@ ?kC TT H ? @ @/(s/`@[BSA{Ĩ_{S[ N/(hs/ |@ *F)@yj RtB")! 6@% c Rтc1b Ti@ys
?) q T y! % x
Tc AH C z Sc ?@ 4@)@ ?k C TcT H ? @ @/(s/[BSA{è_{S[ck+ O(s/ |@ *F)@yj vB")! 9@" T( c R*c B Ti@ys
?) qa T y % x
T A ҥR#c R R * 4 R 4#A4ȢK C ?@ 4@ kTiK T( ? @ @O(s/+@kDcC[BSA{ƨ_ S[c { * *
1 T+ 3(R , 7 Ek" Th~@F 8@ {w)#*@9 6*y {w)#*@9 7(R ** *** (R {¨ @@cB[ASĨ_{S[ck+ Y ** 43 R ~@ ;F@h{z "T9 S? qH TU7H@9 (6B R *T* 4h{z"*9*64H@ @ h{z"*9* 4h{z "( @ ? 4T 4 qBz
TyB5 R R T&@x* " k! T* * q! TR < S 5 q T ) T( ? @C 2 ** h{z"I96 4 q T
q! T**
** **8 @@ ( * ? 5( ?3 (@ ) @H I @@h 5@ 4 q TR(R E R d)bh{z"*@9 06h9 i q TBR 5 U K R+@kDcC[BSA{ƨ_ b R @8+@8HQ e qI hQLi e qhK 5l 4B B_{ A 5 R ǻ A{@_ T {_S { R T{@Ts R C e@
@@8 ij8@8ij8 K 5i 4s @9 4 @HC y I{è @S¨_ S { S R R{¨ @S¨_ u e 4trAT **** C * @ 4 4i*F )@ yj*! I@9( H 9`@GT 4u *S[ck{ *~@ *F 9)@yj *)! *96u j! TC 5@ jA Ts2i
?@q: RX R T(A@Q yr` T(@Q yr T(AQ yr T 9
3*(`Rh
q T 9 9
r T9
07@
R R R
k T
R
k T
R
k! T
@ 4 q T q T q! T3 R 4b R C * q`Az 1 T@ q T q T ka T 9* B R * R * T/ @7 ~ S= R k T&R ߟR k! T RA * `T 9 R * `TS 49 R q T q TߟR S R s R 4 RC 4bK* 1T k T R{¨kCcB[ASĨ_ R ҝ @ S[ { * 9 r**R T q T q T 6
r` T R R R
h ?q T?yr` T?q T?q T? q TI R R i R ?q T?q T? q T dh@ R ) Ri
B q T q T q Tq Tq T P R k h R H R ( R R Rh) 86h9 2h 9x7H j TC 5@ !@q Th9a2h 9@6 IJ(**
j 87( Rh T06h@j@ 2i i@H2h * 2j `6h@ 2i h6h@ 2i (6h@ 2 6h@ 2i {¨@[ASè_ R @ S{ *i~@ *F yj)@)! R+@9ja TK86B R T) @
q T/ @ " R# yC *v#@y q Zz T*O 1 T R * @T R{¨S_S[ck# { * *** ?@H%@c J @ 1h% j T @ 1! T R ( RG@+ RF)K s* C@[ #*E*( A
?kE) D) T7@ R( k T 6( A
6y E* #* ? a T *Fyj)@*! I@9( + iH 9( ?֊ @( ?` 5( ? *| *F)@yj*! I@9( H 9) ( ?5R q Tc92 q Tc9 2 c9@ Ҹ 2*Fc 9yj)@)! 8 9KFykI@)! ? 936@ * 4@R*g c @C 9H%@J @C *h% j @ *u 4*}@ F
@(yk C9K! i 9KFykI@,! @9(ASJ* S R h
J 9 j Ts6 *Fyj)@+! i@9(2h 9 R k T 6( ?( A
z D)E* # ? a T( ? *Fyj)@+! i@9( h 9@ *Fyj)@)! R{Ȩ#@kCcB[ASŨ_*** % R { *C [h q T@@ sx R@9 4 @HC y I{èA_ { C g
T@R kR)S i y{¨A_S[ck# { @ 6 y Қ Rh9h 5" h9h 5B h
9 q"C :
T` @ k T I T
A@Q R )J* yR
U3. x y
U A ҟ y ~HR {¨#@kCcB[ASŨ_ u Җ h9h 5" h9h 5B h
9 q @T A T { _ . a 5 9?`ra T 9?Pr T* R ?<r T R( K q TJ R ?( rA T k Tj R
( a2i 8!|S lh* 9@ _ _ 'HR {_ S { ** 5h9 qෟ& @ 5h9 q T Ti U 4(9 ( 8 qT 5h_8 R q Th9 q T q Ra T q Th9 q T q R@ T R{ @S¨_ S[{ R RD a _ q 9H ?) TSR R *3 R@v 9u 9h 4 R 8B Q_ q T 97@** SH 4 (9 6 9(8 qT ( 9h9 q T@ j H9
h 4( 85(
a P R{[AS¨_S[C @H 4' @ 4 Q Q 5*@_ q T@ C [AS¨_ 5@J 5 > (
q 藟 C [AS¨_
ҟ 1 T
}@
xiK N >h Κ Q }@
1Th` ) q( RK Rh
C [AS¨_ k T K
k * Th}@ H}@.xi xik TJ Q_
kk QT B T
4 Q
.xj Q
5xj( R RZJK S? qTRK 4&!.*" q T Q
+xjh%* ҥ Q%
7}@Ӧ k T|@ xi R QI
xi Q
xj 4@%֚! q(!ԚO T Q
xjh%
* @C > Ú@Ƚ
}@ө T` %@@? T~@ӯ}@j}@ _ Ti ?
J )T R' 4}@ *xiH-* `
xl _
kH
Kk%x,k#TA$I T
R 4 Ҩ }@ H xl+xh k(A+
x,O`ӃT *}@ Q Qe6 @ *_k TH}@ x) @J _kCT 4k Qi
xij 5 k5C [AS¨_ C [AS¨_ {S[ck+ , * c @7 R } qa T 9 c 9@R R R R ( it) @` T+@ 6h ? Th@a T( R a T R hs(*K h 2 q T q T
q` T q Th !? 53 R h h h 1@ 5 R h@ g
t ) R_)@ 9 @3( RL RJ) T d l`* )ZR x (K y r q ) RH R+K qc T3 X RR, 4
R3 3YjYj kA
TJ _ qATQQ
}S' RK) (!ƚ Q3h Q(Yh* RR%* ZHIK K
S_ qZ ?q T k藟
6 qH T Q Qk T
K Q k T3NYh R? k T3Yi R
%(!J*3jY, Qk` TK@O@ R 43?Y(
kTO@K RK R QQ
}S' RK) (!ƚ Q3h Q(Yh* RR%* ZHIK K
S_ qZ ?q T k藟
6 qH T Q Qk T
K Q k T3NYh R? k T3Yi R
%(!J*3jY, Qk` TK@O@ R 43?Y(
kTO@K RK q
Ts% X RR[ c 4
Rs%3YjYj k TJ _ qATZ( RIKR K
S_ qZ ? q'V q T RK Q? 1 T( Q? k T3JYi
R k T3hYh RHy3hY)) Q? 1` TK@O@K ȆRKt~S~~ Rh ) R)! *IY4}~ s_0h Tˣ6 q Z* RHIKR K
S_ qZ ? q'V q T RK Q? 1 T( Q? k T3JYi
R k T3hYh RH}3hY)) Q? 1` TK@O@K R9 Rp B BHU !7~`YS 4I R? q Q)=3 Rt
@9u@9~ӈ Ui@yH ~ @ uC? q TC 5 R q Tw 4 R RsYk}
A)Y+k kI`!T 4B q TsIY(B B R R q T *@"}~ _0s TC 9 RHR ;B B34 q
T
4 R RsYk}
A)Y+k kI`!T?k'?ksc1?ksb1?k$1 q R R 4fXn 5k T ?Y.1 R* Re 4q Tk T Y- LXg+Xm k} A/=*A+ )X-7@ ET/ 4q Tk T Y- HYm A/IY-/`E /5q
T kT*}~ _0s TҢ 9 RHR ʳB B) R 4 @I 9K5@HS u S*
Z
K 4h ! i Q
Yi
4_ q T 4 R R
sYk}
A)Y+k kI`!T) 4B q TsIY(B " 4 R R3M҈Yk}
A)Y+k kI`!T)! 4K@ q T3IY(K@ K KH`Sw 4I R q Q)=3 Rt
@9u@9~ӈ Ii@yH ~ @ iC? q TC 5 RK q` TV 4 R R3Yk}
A)Y+k kI`!Ti 4K@ q T3IY(K@ K O@ RK R q T *K 3@"}~ _03 T7 9 R ~HR /gI)S4 q
T
4 R R3Yk}
A)Y+k kI`!T?k'?k3c1?k3b1?k$1 q R R 4fXn 5k T Y.2 R* R 4q Tk T Y- LXg+Xm k| A+, *A/ )X-7@ ETO 4q@
Tk T Y- iYm}@
A)jY-O`E 5q T kTK ~~ _03 Tǡ 9 RHR K@O@( RH 4 @I K5S u S*
X K
K4h ! i Q
Yi 4_ qT4 R R
3Yk}
A)Y+k kI`!TI 4K@ q" T3IY(K@ K K@K K 93 c#<@ ( q T)RBi 9 s 4 R RsNҨYk}
A)Y+k kI`!T) 4B q TsIY(B 9sz 5 Q h 9s @@ 7 _k
#@ ?A*H}@)145 TK@ N 4 R R3
XYk}
A)Y+k kI`!T) 4K@ q T3IY(K@ K K 93A c#K@
R *K q 9h}
k `ӊ}SHu S
L k Kj H }S T q hJ-8 Q 1T 9 % )(T@9 9 q@9h 4c *,+@kDcC[BSA{ƨ_ R ʚ; S { s R @ 'R رR{ @S¨_ֿ S T͠ R R TSR *{
{_S { C 9h@; r Th.@ R Kh h i"@ q* Qj M Ta@* *i@kC9( 9" qI T |@ *F)@yj +! h h@9/6B R Q TjR I_) 2I5; R " RC q{¨ @S¨_ S { # yQh@; r Th.@ R Kh h i"@ q* Qj M Ta@*b *i@k#@y( y" qI T |@ *F)@yj +! h h@9/6B R TjR I_) 2I5; R B RC < q{¨ @S¨_ { @;
Sh 4 R" @; r T$@ @ T @;բ T( # RC ?ր 4( a c ?֠ 4#A? R{¨A_ S{ *h@; r T=(R jR I_) 2I5; G h@;1 SH 4.HR jR I_) 2I5h@; 6 jR Sh 4h@h I_)y I5;jR I_) 2I5;jR I_)y I5; h@; R j TH Sh 5 S 5jR I_) 2I5I_) 2I5 {S_ S{ *~h@; r T(R jR I_) 2I5;RG h@;1 SH 4HR jR I_) 2I5h@; 6K jR Sh 4h@h I_)y I5;jR I_) 2I5;jR I_)y I5; h@; R j T Sh 5P > S S 5jR I_) 2I5I_) 2I5> {S_ S[c{ C * q ** T~@C * q Ta~@= * 4 4 *** kh} y *
H R C {cB[ASè_ {S[ck+ C *A q *** Ta~@ * 1 T q T~@ * 1k Tw 5@
@S 4 5k@ T q T q, T( A A# * ? 4 qM TH @ q TH;@9J; H 4K@9 4@9H@9?k*!Kz TH-@85` R qM TH @ q TH;@9J; H 4K@9 4)@9H@9?k*!Kz TH-@85 R| R *!R* *X 4 A ? R T< L T|Dds/C t R B T **! R*@ 4 R *!R* *6 4~ A ? T< L T|D8s/C s R Rh sB ҳ **! R* 4@@ *** * R3 h_R k T`B R _R ka TB * @ R R_C +@kDcC[BSA{ƨ_ S[c { C ****۱****c @9 4 @HC y I{è@cB[ASĨ_ { j HO ! It` ҝh@jR I_)2I5; R I_)2I5;hr h H Rh" h@ h {A_ {S[ck+ R ɮ+@kDcC[BSA{ƨ_vY? T( c i# 7 ֚* _! H T T TbA ? ? qtT TH9k щi8i*8I 8k T@ HA}bAt ? ? q T_ Tjh8I9 H 9i 8LbA ? ? q T_ TLH9k щi8i*8I 8kbA ? ? q T TH9k щi8i*8I 8k TB TbA ? ? qT ( TbA ? ? qT; ˿) ThcA ? ? qT T TlH9k щi8i*8I 8k7 @ TI T( aA ? ?4
; ThcA ? ?4 @ W@ T_ Tw k {# 7 T9 Tx k {# _b T,7 k ѵ" W {# +@x@# { A R
c 9" 9R íR{_ L Ti8h 8 4) щ
i8h 8 4) i J JJ 9i T 8
R 9HR @R{ J R }@? B T ?i*8 qKT) @9i 4 - R+C( iil8!H *) @8hi,8)5 @9i 4+ R ( )Cj!(il8_j T @8)5 -{_ֈ S{ R e STC @ @h 5`
k k џ Th@9 e@9I7h @j @ @9 4 @HC y I{èS_{S[ck+ C C *E q *** Ta~@ k w 5@
@Hs@*R) R R qA**e *x 5 R A ? R T< L T|D՝s/C t R B **! R*>
4 R ** *U 49P66 4k TD@ ***{ *u 59 ~ A ? T< L T|Dӕs/C s R ? Rh sB ***S 4 * R* 5 R * 5h_R ka T`B F R _R ka TB >*_C C J+@kDcC[BSA{ƨ_D@*h_R kT`B *S[c { C ****2@*** * #@9 4@HC y IC {è@cB[ASĨ_ { S q{_S[{ S C 9 R; 9@)R
@ k! T@9 4 @HC y I"R @9 5 4 @HC y I" R 4 @HC y I R 5 ڮ @)R
@ k! T#A9 4@HC y I"R #A9 5 4@HC y I" R 4@HC y I RCb` 5 3@K@ ?A93@ * A93@ Ru 4B9h 4K@*{˨[AS¨_ { %R ֫ h
E (A R ?{_ S[{ <$ d H T !v E R ?ր !( 4 4E R ?֠ R {[AS¨_ { # y 4S ! RC ` 4#@y R{¨_ S[c{ " R *K *B R F T T M T! R R*>@ R *"* 1 T Rs * m T@ 1T @ q TR @! * R R* @ T* ? 5}R ( ? *k s @ R**{cB[ASè_ { țC h A) j -? .? ( G? g [ H
@y 5@9 87O qQ h qa TL R
h
qa Tl R h q T R R) R K(! Q+
* L@9
SK@ S? qAz T k T 8 qa T * T?
T)KK L y SI
y RhK qi TADq" TR R( R ) (yhk TO q_ _ HR C c{_ { *Ax
j T R R9 ` R R 0 ` - R{A_ { ` ` R{A_ { `@ `@I C @ 5@h@ k T@ Rh@ k@ T R{¨A_ { C 5 @C @h ( 2 5 R R{¨A_ f )L T@` T
%RR# RH /& RaR; @ TER RC R X X Tn ` t \ 8p p \ \ \+q f }`r ;g;{ y*s z
|
\8 y OT
\RX y BX u +q R } yK] Yg^ `g^ ; " Tz \gR1:p .f Rn2 \ 2l ȵm} \l ~ \b (-Lgt+KiQ}@8b
H Au
r ymH :u P \VQ U \q \s t \KT 7 y BU ymFW \t
w fY *u _V X } yc] Rg^ `K^ _ V ]4 x?Q#Ib?ƺ? ?^?AG;BIb?WUUUUU? B.? _D;
R
J}S
r T Pq T `q T pq `R R @R Rr R_ qR q R** qK RI* q**}
SK * j *K*`*_(D;* r R _ q R qO R** qJ*}SK * j * @ *_ r T q T q T q
D; }@( X+ Sj q I q q * q @I q * qI)* H D_`?
r(D; X
S K qj qH K q i q *I)D_` (9 4 T h85_ { s `D TH (A
Rd R b R R ?` {A_ h D T _ S[ { w D * * ? * 5 ? q TD T ?H (A
Rd R b R R ? * ? **{@[ASè_ |S
H 2 rKh 2 rjH 2 rKh 2 rjH
2 rK
r T Pq T `q T pq Tk2 k2 k2 rh2`_ *Rj R T SH 2 rKh 2 rjH 2 rKh 2 r`L 86
2_ (D; }@ (D{ ,
*D;
R
J*,**
N* k T
m SH2 rKh2 rjH2 rKh2 rjH2
rKr T q T q T q Tk
2 k
2 k 2h2rRj
@* DՋ{_ S { * 6 @6 Ҥ sz 6 H6@ Ҟ sz
6 P6 Ҙ sz 6 X6u 6 ґ sz 6 `6 Ҍ sz q{ @S¨_{S[c# ' y X (@` * ***b pg * 5
q T@i R; ( 3 # C ** ) R S( 4 4@mm@ A c S` 5*& @ *" @5 @p'@#@cC[BSA{Ũ_ M g_ R S[c{ @** @ ?
6 @ H@ 2I 6 @ H@ 2I 6 @T H@ 2I 6 @ H@ 2I 6 @ H@ 2I h@ @ HӨ @)*iJ*,
J h@ @ I @)*iJ*,
J h@ @ JӨ @ )*iJ*,
J h@ @ K @)*iJ*,
J h@ @ LӨ @)*h 3 6 @H
@ 2I
6 @H
@ 2I
6 @H
@ 2I
6 @H
@ 2I
6 @H
@ 2I
h@
r` T_Pq` T_`q T_pq! T @H@ 2 * R J R @(@H 3( @H@ u I @@ J*+-h
J @H!@ 2I! @h!@V 4 mi! @@P @ha@ 2ia @Ha@ mIa @@QQ ) R(
3h! @@0 @Ha@ 2Ia @) Rha@(
3ha @@1) Z C " R R* ? @H @ 6h@ wi H @ 6h@ vi H @ 6h@ ui H @ 6h@ ti H @ 6h@ si H@ r T? q T? q T?
q Th@ j
) h@(jh I h@ hi 4PQ@ Q)@ {¨cB[ASè_
{ q T Q q THR (R {_ (D; }@
*D_ D;
R
J!*-)|@|@ i D_(D;
}@K +D_ (D; }@_ <@ R
(I)@yL
@y(
a 4
I@?@) TH@ ?@) Tk k J T _ S{ 4 ` 5 R
aˀ ` R $@h* R{S_ @yIR ka T<@ R
(I@? k TH1@y R -q@ T R_{ h @ @+u (kj}@I*@! ڔ R{_ ! 5 9 4
|j7p= S %Ț N2
NI>N*` TI H>N )I87(}@`
Hw }@H S
%Ț 1
)>N* TH }@Ӏ
Ii lA < N0:n>N1
N(>N
}S (>N +j}SA* A V 4 N| =
N4n1
Nr
N,>NO>N 7 S)>NJ%ȚH>N-
(! Q q SJ%ɚOL
҆R k L
k i _ kc Tl>Nk>NJ86k i K H <4n Nq
NR
N+>N/>NM>NL>N)
(!ʚ * KډR) K HQ(!Ț * ` TI K(}@ H _ 9 5 4
|j7p= S %Ț N2
NI>N*` TI H>N )I87(}@`
Hr }@H S
%Ț 1
)>N* TH }@Ӏ
Id lA < N0:n>N1
N(>N
}S (>N +j}SA* A Q h 5 N |
73 Np= SJ%Ț NR
N3nH>N1
N)>N.>N
,
` T H>N *l _ k+T- T(}@`
,
}@( SI%Ț0
>N0 10.1
(>N
_ T TH
}@
3 NkA p< N3n NQ:n(>NHR
NH>Nh H>N )(}@i
H+A j9_!k`__ B T @8 !k` TB т _ t 3 @3.1
(>N ?q T(}@
_ @1g J _A c T6 N_ TpE@i r = mA n 6n0=+A 76nJT6n6n N N1 N2:nH>N( _T_A # TpN _A "T_! Tp@3.1
(>N ?q T(}@`
5 3;nh>N( :n>Nh
N
N :n>N
N N>Nh >N )(}@
1
N(>Nh (>N )(}@i
A J! k! h@8 !k` TJ ъh _ _{ ( @ @k {_a { @ @ ?
k{_a { ȨC@9 4 ( @c )ȱc * H@ ka Tc ( @? q Tc (ȩ !@ k Tc ( !@ k Tc (i !@ k TKc ( )3@D l ձS ?S ߈{A_a csm !"{ @J {_a { R& {_a {@ @x ՠ @5 {_a { @ @, {_a { @ @ {_a {`R {_a { @ @ {_a { @ @ {_a {@ @ {_a {@ġ {_a { R {_a { @ @ {_a { R {_a { R {_a { R {_a {C@9 4` R {_a {@H 4@@ 4i*Fh )@ yj*! I@9( H 9`@y {_a { @ @ R
r?
k{_a H_ Z_ r_ _ _ _ _ _ _ ` "` 2` H` Z` j` ` ` ` ` ` ` ` ` e ~e pe de Te \a va a a a a a b b "b .b > << ! == != [] operator -> * ++ -- - + & ->* / % < <= > >= , () ~ ^ | && || *= += -= /= %= >>= <<= &= |= ^= `vftable' `vbtable' `vcall' `typeof' `local static guard' `string' `vbase destructor' `vector deleting destructor' `default constructor closure' `scalar deleting destructor' `vector constructor iterator' `vector destructor iterator' `vector vbase constructor iterator' `virtual displacement map' `eh vector constructor iterator' `eh vector destructor iterator' `eh vector vbase constructor iterator' `copy constructor closure' `udt returning' `EH `RTTI `local vftable' `local vftable constructor closure' new[] delete[] `omni callsig' `placement delete closure' `placement delete[] closure' `managed vector constructor iterator' `managed vector destructor iterator' `eh vector copy constructor iterator' `eh vector vbase copy constructor iterator' `dynamic initializer for ' `dynamic atexit destructor for ' `vector copy constructor iterator' `vector vbase copy constructor iterator' `managed vector copy constructor iterator' `local static thread guard' operator "" operator co_await operator<=> Type Descriptor' Base Class Descriptor at ( Base Class Array' Class Hierarchy Descriptor' Complete Object Locator' `anonymous namespace' ( n u l l ) (null) m s c o r e e . d l l CorExitProcess @ @ @ @ X @ p8 @ p8 @ @ @ P@ P@ @ @ @ @ @ H @ p8 @ x6@ p8 @ @ @ p8 @ ( @ @ p8 @
!
5 A
C P R
S
W Y l
m p r
)
Y * `@ @ @ @ p@ @ @ `@ @ @ @ `@ @ @ `@ @ @ @ @ 8@ a p i - m s - w i n - c o r e - d a t e t i m e - l 1 - 1 - 1 a p i - m s - w i n - c o r e - f i b e r s - l 1 - 1 - 1 a p i - m s - w i n - c o r e - f i l e - l 1 - 2 - 2 a p i - m s - w i n - c o r e - l o c a l i z a t i o n - l 1 - 2 - 1 a p i - m s - w i n - c o r e - l o c a l i z a t i o n - o b s o l e t e - l 1 - 2 - 0 a p i - m s - w i n - c o r e - p r o c e s s t h r e a d s - l 1 - 1 - 2 a p i - m s - w i n - c o r e - s t r i n g - l 1 - 1 - 0 a p i - m s - w i n - c o r e - s y n c h - l 1 - 2 - 0 a p i - m s - w i n - c o r e - s y s i n f o - l 1 - 2 - 1 a p i - m s - w i n - c o r e - w i n r t - l 1 - 1 - 0 a p i - m s - w i n - c o r e - x s t a t e - l 2 - 1 - 0 a p i - m s - w i n - r t c o r e - n t u s e r - w i n d o w - l 1 - 1 - 0 a p i - m s - w i n - s e c u r i t y - s y s t e m f u n c t i o n s - l 1 - 1 - 0 e x t - m s - w i n - n t u s e r - d i a l o g b o x - l 1 - 1 - 0 e x t - m s - w i n - n t u s e r - w i n d o w s t a t i o n - l 1 - 1 - 0 a d v a p i 3 2 k e r n e l 3 2 n t d l l a p i - m s - w i n - a p p m o d e l - r u n t i m e - l 1 - 1 - 2 u s e r 3 2 a p i - m s - e x t - m s - AreFileApisANSI CompareStringEx FlsAlloc FlsFree FlsGetValue FlsSetValue InitializeCriticalSectionEx LCMapStringEx LocaleNameToLCID AppPolicyGetProcessTerminationMethod c c s U T F - 8 U T F - 1 6 L E U N I C O D E ( ( ( ( ( H
!"#$%&'()*+,-./0123456789:;<=>?@abcdefghijklmnopqrstuvwxyz[\]^_`abcdefghijklmnopqrstuvwxyz{|}~
!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`ABCDEFGHIJKLMNOPQRSTUVWXYZ{|}~ ( ( ( ( ( H ( 0 @@ @@ D@ D@ H@ H@ L@ L@ P@ H@ `@ L@ p@ H@ @ L@ INF inf NAN nan NAN(SNAN) nan(snan) NAN(IND) nan(ind) e+000 `@ d@ h@ l@ p@ t@ x@ |@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ $ @ , @ 4 @ @ @ P @ X @ h @ t @ x @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ 8@ P@ `@ x@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ 0@ @@ P@ h@ x@ @ @ @ @ @ @ @ Sun Mon Tue Wed Thu Fri Sat Sunday Monday Tuesday Wednesday Thursday Friday Saturday Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec January February March April June July August September October November December AM PM MM/dd/yy dddd, MMMM dd, yyyy HH:mm:ss S u n M o n T u e W e d T h u F r i S a t S u n d a y M o n d a y T u e s d a y W e d n e s d a y T h u r s d a y F r i d a y S a t u r d a y J a n F e b M a r A p r M a y J u n J u l A u g S e p O c t N o v D e c J a n u a r y F e b r u a r y M a r c h A p r i l J u n e J u l y A u g u s t S e p t e m b e r O c t o b e r N o v e m b e r D e c e m b e r A M P M M M / d d / y y d d d d , M M M M d d , y y y y H H : m m : s s e n - U S j a - J P z h - C N k o - K R z h - T W u k @ @ @ @ @ @ @ @ @
@ @ @
@ @ (@ 0@ 8@ @@ H@ P@ X@ `@ h@ p@ x@ @ @ @ @ @ @ ! @ " \@ # @ $ @ % @ & @ ' @ ) @ * @ + @ , @ - @ / @ 6 @ 7 @ 8 @ 9 (@ > 0@ ? 8@ @ @@ A H@ C P@ D X@ F `@ G h@ I p@ J x@ K @ N @ O @ P @ V @ W @ Z @ e @ dE@ @ @ @ P@ @ @ @ @ @ 0@ @@
P@ `@ p@ @ @ @@ @ @ @ @ @ @ @ @ @ @ 0@ @@ P@ ! `@ " p@ # @ $ @ % @ & @ ' @ ) @ * @ + @ , @ - @ / (@ 2 8@ 4 H@ 5 X@ 6 h@ 7 x@ 8 @ 9 @ : @ ; @ > @ ? @ @ @ A @ C @ D @ E 0@ F @@ G P@ I `@ J p@ K @ L @ N @ O @ P @ R @ V @ W @ Z @ e @ k @ l 0@ @@ P@ 0@ `@ p@
@ @ @ @ @ @ @ @ , @ ; @ > 0@ C @@ k X@ h@ x@ @ @
@ @ @ ; @ k @ @ @ @ 0@
@@ P@ `@ ; p@ @ @ @ @
@ @ @ ; @ @ @
(@ 8@ H@ ; `@ p@ @
@ @ ; @ @ @
@ ; @ $ @ $ @
$ ( @ ;$ 8 @ ( H @ ( X @
( h @ , x @ , @
, @ 0 @ 0 @
0 @ 4 @ 4 @
4 @ 8 @
8 @ < ( @
< 8 @ @ H @
@ X @
D h @
H x @
L @
P @ | @ | @ a r b g c a z h - C H S c s d a d e e l e n e s f i f r h e h u i s i t j a k o n l n o p l p t r o r u h r s k s q s v t h t r u r i d b e s l e t l v l t f a v i h y a z e u m k a f k a f o h i m s k k k y s w u z t t p a g u t a t e k n m r s a m n g l k o k s y r d i v a r - S A b g - B G c a - E S c s - C Z d a - D K d e - D E e l - G R f i - F I f r - F R h e - I L h u - H U i s - I S i t - I T n l - N L n b - N O p l - P L p t - B R r o - R O r u - R U h r - H R s k - S K s q - A L s v - S E t h - T H t r - T R u r - P K i d - I D u k - U A b e - B Y s l - S I e t - E E l v - L V l t - L T f a - I R v i - V N h y - A M a z - A Z - L a t n e u - E S m k - M K t n - Z A x h - Z A z u - Z A a f - Z A k a - G E f o - F O h i - I N m t - M T s e - N O m s - M Y k k - K Z k y - K G s w - K E u z - U Z - L a t n t t - R U b n - I N p a - I N g u - I N t a - I N t e - I N k n - I N m l - I N m r - I N s a - I N m n - M N c y - G B g l - E S k o k - I N s y r - S Y d i v - M V q u z - B O n s - Z A m i - N Z a r - I Q d e - C H e n - G B e s - M X f r - B E i t - C H n l - B E n n - N O p t - P T s r - S P - L a t n s v - F I a z - A Z - C y r l s e - S E m s - B N u z - U Z - C y r l q u z - E C a r - E G z h - H K d e - A T e n - A U e s - E S f r - C A s r - S P - C y r l s e - F I q u z - P E a r - L Y z h - S G d e - L U e n - C A e s - G T f r - C H h r - B A s m j - N O a r - D Z z h - M O d e - L I e n - N Z e s - C R f r - L U b s - B A - L a t n s m j - S E a r - M A e n - I E e s - P A f r - M C s r - B A - L a t n s m a - N O a r - T N e n - Z A e s - D O s r - B A - C y r l s m a - S E a r - O M e n - J M e s - V E s m s - F I a r - Y E e n - C B e s - C O s m n - F I a r - S Y e n - B Z e s - P E a r - J O e n - T T e s - A R a r - L B e n - Z W e s - E C a r - K W e n - P H e s - C L a r - A E e s - U Y a r - B H e s - P Y a r - Q A e s - B O e s - S V e s - H N e s - N I e s - P R z h - C H T s r dE@ B @ , ,@ q @ ,@ ,@ 0,@ @,@ P,@ `,@ p,@ ,@ ,@ ,@ ,@ ,@ ,@ C ,@ ,@ -@ @ ) -@ (-@ k @ ! @-@ c @ P-@ D `-@ } p-@ @ -@ E @ -@ G -@ @ -@ H @ -@ -@ -@ I -@ .@ @ A .@ @ (.@ J @ 8.@ H.@ X.@ h.@ x.@ .@ .@ .@ .@ .@ .@ K .@ .@ @ /@ /@ (/@ 8/@ H/@ X/@ h/@ x/@ /@ /@ /@ /@ /@ /@ /@ /@ 0@ 0@ (0@ @ # 80@ e @ * H0@ l @ & X0@ h @
h0@ L @ . x0@ s @ 0@ 0@ 0@ 0@ M 0@ 0@ @ > 0@ h@ 7 0@ @ 1@ N (@ / 1@ t x@ (1@ 81@ Z @
H1@ O @ ( X1@ j @ h1@ a (@ x1@ P 0@ 1@ 1@ Q 8@ 1@ R @ - 1@ r 8@ 1 1@ x @ : 1@ @@ @ ? 1@ 1@ S @@ 2 2@ y @ % 2@ g @ $ (2@ f 82@ @ + H2@ m X2@ @ = h2@ @ ; x2@ 0@ 0 2@ 2@ w 2@ u 2@ U H@ 2@ 2@ T 2@ P@ 2@ `@ 6 3@ ~ X@ 3@ V `@ (3@ W 83@ H3@ X3@ h3@ h@ x3@ X p@ 3@ Y @ < 3@ 3@ 3@ v 3@ @ 3@ [ @ " 3@ d 3@ 4@ 4@ (4@ 84@ H4@ @ X4@ \ @ h4@ 4@ 4@ 4@ @ 4@ 4@ ] H@ 3 4@ z @ @ 4@ p@ 8 5@ x@ 9 5@ @ (5@ ^ 85@ n @ H5@ _ X@ 5 X5@ | \@ h5@ b @ x5@ ` P@ 4 5@ 5@ { @ ' 5@ i 5@ o 5@ 5@ 5@ 6@ 6@ (6@ 86@ F H6@ p a f - z a a r - a e a r - b h a r - d z a r - e g a r - i q a r - j o a r - k w a r - l b a r - l y a r - m a a r - o m a r - q a a r - s a a r - s y a r - t n a r - y e a z - a z - c y r l a z - a z - l a t n b e - b y b g - b g b n - i n b s - b a - l a t n c a - e s c s - c z c y - g b d a - d k d e - a t d e - c h d e - d e d e - l i d e - l u d i v - m v e l - g r e n - a u e n - b z e n - c a e n - c b e n - g b e n - i e e n - j m e n - n z e n - p h e n - t t e n - u s e n - z a e n - z w e s - a r e s - b o e s - c l e s - c o e s - c r e s - d o e s - e c e s - e s e s - g t e s - h n e s - m x e s - n i e s - p a e s - p e e s - p r e s - p y e s - s v e s - u y e s - v e e t - e e e u - e s f a - i r f i - f i f o - f o f r - b e f r - c a f r - c h f r - f r f r - l u f r - m c g l - e s g u - i n h e - i l h i - i n h r - b a h r - h r h u - h u h y - a m i d - i d i s - i s i t - c h i t - i t j a - j p k a - g e k k - k z k n - i n k o k - i n k o - k r k y - k g l t - l t l v - l v m i - n z m k - m k m l - i n m n - m n m r - i n m s - b n m s - m y m t - m t n b - n o n l - b e n l - n l n n - n o n s - z a p a - i n p l - p l p t - b r p t - p t q u z - b o q u z - e c q u z - p e r o - r o r u - r u s a - i n s e - f i s e - n o s e - s e s k - s k s l - s i s m a - n o s m a - s e s m j - n o s m j - s e s m n - f i s m s - f i s q - a l s r - b a - c y r l s r - b a - l a t n s r - s p - c y r l s r - s p - l a t n s v - f i s v - s e s w - k e s y r - s y t a - i n t e - i n t h - t h t n - z a t r - t r t t - r u u k - u a u r - p k u z - u z - c y r l u z - u z - l a t n v i - v n x h - z a z h - c h s z h - c h t z h - c n z h - h k z h - m o z h - s g z h - t w z u - z a T c-^k @tFМ, a\)c d4҇f;lD ِe,BbE"&'O @V$ gmsmr d'c%{pk >_ nj f2 9.EZ%qVJ .C|!@Ί Ą' |Ô%I @T̿aYܫ\ DgR)`* ! VG6K]_܀
@َЀk#c d8L2WBJa"=